@openprd/cli 0.1.1 → 0.1.8

package/docs/assets/openprd-requirement-routing-en.svg

@@ -0,0 +1,102 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="980" viewBox="0 0 1600 980" role="img" aria-labelledby="title desc">
+  <title id="title">OpenPrd requirement routing</title>
+  <desc id="desc">A diagram showing how OpenPrd routes incoming requests into quick fixes, existing-flow improvements, or new feature and workflow work.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#fff8f1"/>
+      <stop offset="0.45" stop-color="#f8fbff"/>
+      <stop offset="1" stop-color="#f6f2ff"/>
+    </linearGradient>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="16" stdDeviation="18" flood-color="#0f172a" flood-opacity="0.12"/>
+    </filter>
+    <marker id="arrow" viewBox="0 0 12 12" refX="11" refY="6" markerWidth="10" markerHeight="10" orient="auto">
+      <path d="M2 2 L10 6 L2 10 Z" fill="#475569"/>
+    </marker>
+    <style>
+      .eyebrow { font: 700 20px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; letter-spacing: 2px; fill: #2563eb; }
+      .title { font: 800 56px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #0f172a; }
+      .subtitle { font: 500 26px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #334155; }
+      .card-title { font: 800 28px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #111827; }
+      .card-body { font: 500 20px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #475569; }
+      .pill { font: 700 18px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #ffffff; }
+      .footer-title { font: 700 22px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #0f172a; }
+      .footer-body { font: 500 18px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #475569; }
+      .line { fill: none; stroke: #64748b; stroke-width: 4; marker-end: url(#arrow); }
+      .dash { fill: none; stroke: #94a3b8; stroke-width: 3; stroke-dasharray: 10 10; }
+    </style>
+  </defs>
+
+  <rect width="1600" height="980" fill="url(#bg)"/>
+  <path d="M0 126 H1600 M0 292 H1600 M0 458 H1600 M0 624 H1600 M0 790 H1600 M190 0 V980 M390 0 V980 M590 0 V980 M790 0 V980 M990 0 V980 M1190 0 V980 M1390 0 V980" stroke="#dbeafe" stroke-width="1" opacity="0.65"/>
+
+  <g transform="translate(92 78)">
+    <text class="eyebrow" x="0" y="0">OPENPRD REQUIREMENT INTAKE</text>
+    <text class="title" x="0" y="78">How OpenPrd routes a request</text>
+    <text class="subtitle" x="2" y="126">First clarify the goal, situation, and risks, then decide whether to act directly, share a mini-plan, or move into a full change flow.</text>
+  </g>
+
+  <g transform="translate(96 220)" filter="url(#shadow)">
+    <rect width="420" height="280" rx="22" fill="#ffffff" stroke="#fdba74" stroke-width="2"/>
+    <rect x="30" y="28" width="104" height="38" rx="19" fill="#f97316"/>
+    <text class="pill" x="62" y="53">01</text>
+    <text class="card-title" x="30" y="108">Quick fix</text>
+    <text class="card-body" x="30" y="152">The issue is already clear</text>
+    <text class="card-body" x="30" y="184">The blast radius is small</text>
+    <text class="card-body" x="30" y="216">Success is easy to verify</text>
+    <text class="card-body" x="30" y="248">Usually handled directly</text>
+    <text class="card-body" x="30" y="280">Then reported back clearly</text>
+  </g>
+
+  <g transform="translate(590 220)" filter="url(#shadow)">
+    <rect width="420" height="280" rx="22" fill="#ffffff" stroke="#c4b5fd" stroke-width="2"/>
+    <rect x="30" y="28" width="104" height="38" rx="19" fill="#7c3aed"/>
+    <text class="pill" x="62" y="53">02</text>
+    <text class="card-title" x="30" y="108">Existing-flow improvement</text>
+    <text class="card-body" x="30" y="152">The goal is clear</text>
+    <text class="card-body" x="30" y="184">But several screens, states,</text>
+    <text class="card-body" x="30" y="216">or user actions are involved</text>
+    <text class="card-body" x="30" y="248">Start with a plain-language</text>
+    <text class="card-body" x="30" y="280">mini-plan, then continue</text>
+  </g>
+
+  <g transform="translate(1084 220)" filter="url(#shadow)">
+    <rect width="420" height="280" rx="22" fill="#ffffff" stroke="#86efac" stroke-width="2"/>
+    <rect x="30" y="28" width="104" height="38" rx="19" fill="#16a34a"/>
+    <text class="pill" x="62" y="53">03</text>
+    <text class="card-title" x="30" y="108">New feature / workflow</text>
+    <text class="card-body" x="30" y="152">The surface area is bigger</text>
+    <text class="card-body" x="30" y="184">More roles are involved</text>
+    <text class="card-body" x="30" y="216">Or business risk is unclear</text>
+    <text class="card-body" x="30" y="248">Clarify the first version</text>
+    <text class="card-body" x="30" y="280">before the full plan path</text>
+  </g>
+
+  <path class="line" d="M516 360 H578"/>
+  <path class="line" d="M1010 360 H1072"/>
+
+  <g transform="translate(220 566)" filter="url(#shadow)">
+    <rect width="1160" height="156" rx="24" fill="#ffffff" stroke="#dbeafe" stroke-width="2"/>
+    <text class="footer-title" x="40" y="54">Start with the business problem</text>
+    <text class="footer-body" x="40" y="90">Who is stuck, in what situation, and what should be solved first.</text>
+    <path class="dash" d="M438 78 H538"/>
+    <text class="footer-title" x="576" y="54">OpenPrd summarizes first</text>
+    <text class="footer-body" x="576" y="90">It brings the goal, scope, non-goals, and risks into one view.</text>
+    <path class="dash" d="M952 78 H1052"/>
+    <text class="footer-title" x="1088" y="54">Then it picks the right rhythm</text>
+    <text class="footer-body" x="1088" y="90">This avoids both heavy process too early and premature implementation.</text>
+  </g>
+
+  <g transform="translate(120 792)" filter="url(#shadow)">
+    <rect width="1360" height="110" rx="24" fill="#ffffff" stroke="#dbeafe" stroke-width="2"/>
+    <circle cx="72" cy="55" r="28" fill="#fb923c"/>
+    <circle cx="460" cy="55" r="28" fill="#38bdf8"/>
+    <circle cx="864" cy="55" r="28" fill="#34d399"/>
+    <text class="footer-title" x="118" y="44">Consumer requests</text>
+    <text class="footer-body" x="118" y="74">Focus on the user moment, first felt value, and return motivation.</text>
+    <text class="footer-title" x="506" y="44">B2B requests</text>
+    <text class="footer-body" x="506" y="74">Focus on who approves, who uses, and who must drive rollout.</text>
+    <text class="footer-title" x="910" y="44">Agent requests</text>
+    <text class="footer-body" x="910" y="74">Focus on what can be automated and where human backup is required.</text>
+  </g>
+</svg>

package/docs/assets/openprd-requirement-routing-zh.svg

@@ -0,0 +1,102 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="980" viewBox="0 0 1600 980" role="img" aria-labelledby="title desc">
+  <title id="title">OpenPrd 需求分流节奏</title>
+  <desc id="desc">一张说明 OpenPrd 如何把用户需求分成快速修正、现有功能优化和新功能新流程方案的流程图。</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#fff8f1"/>
+      <stop offset="0.45" stop-color="#f8fbff"/>
+      <stop offset="1" stop-color="#f6f2ff"/>
+    </linearGradient>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="16" stdDeviation="18" flood-color="#0f172a" flood-opacity="0.12"/>
+    </filter>
+    <marker id="arrow" viewBox="0 0 12 12" refX="11" refY="6" markerWidth="10" markerHeight="10" orient="auto">
+      <path d="M2 2 L10 6 L2 10 Z" fill="#475569"/>
+    </marker>
+    <style>
+      .eyebrow { font: 700 20px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; letter-spacing: 2px; fill: #2563eb; }
+      .title { font: 800 56px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #0f172a; }
+      .subtitle { font: 500 26px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #334155; }
+      .card-title { font: 800 28px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #111827; }
+      .card-body { font: 500 20px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #475569; }
+      .pill { font: 700 18px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #ffffff; }
+      .footer-title { font: 700 22px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #0f172a; }
+      .footer-body { font: 500 18px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #475569; }
+      .line { fill: none; stroke: #64748b; stroke-width: 4; marker-end: url(#arrow); }
+      .dash { fill: none; stroke: #94a3b8; stroke-width: 3; stroke-dasharray: 10 10; }
+    </style>
+  </defs>
+
+  <rect width="1600" height="980" fill="url(#bg)"/>
+  <path d="M0 126 H1600 M0 292 H1600 M0 458 H1600 M0 624 H1600 M0 790 H1600 M190 0 V980 M390 0 V980 M590 0 V980 M790 0 V980 M990 0 V980 M1190 0 V980 M1390 0 V980" stroke="#dbeafe" stroke-width="1" opacity="0.65"/>
+
+  <g transform="translate(92 78)">
+    <text class="eyebrow" x="0" y="0">OPENPRD REQUIREMENT INTAKE</text>
+    <text class="title" x="0" y="78">一句需求进来，OpenPrd 怎么接住</text>
+    <text class="subtitle" x="2" y="126">先帮你把目标、场景和风险说清楚，再决定是直接改、先给 mini-plan，还是进入完整方案。</text>
+  </g>
+
+  <g transform="translate(96 220)" filter="url(#shadow)">
+    <rect width="420" height="280" rx="22" fill="#ffffff" stroke="#fdba74" stroke-width="2"/>
+    <rect x="30" y="28" width="104" height="38" rx="19" fill="#f97316"/>
+    <text class="pill" x="62" y="53">01</text>
+    <text class="card-title" x="30" y="108">快速修正</text>
+    <text class="card-body" x="30" y="152">问题已经很明确</text>
+    <text class="card-body" x="30" y="184">影响小，验收也清楚</text>
+    <text class="card-body" x="30" y="216">通常直接处理</text>
+    <text class="card-body" x="30" y="248">做完告诉你改了什么</text>
+    <text class="card-body" x="30" y="280">以及怎么验证</text>
+  </g>
+
+  <g transform="translate(590 220)" filter="url(#shadow)">
+    <rect width="420" height="280" rx="22" fill="#ffffff" stroke="#c4b5fd" stroke-width="2"/>
+    <rect x="30" y="28" width="104" height="38" rx="19" fill="#7c3aed"/>
+    <text class="pill" x="62" y="53">02</text>
+    <text class="card-title" x="30" y="108">现有功能优化</text>
+    <text class="card-body" x="30" y="152">目标明确</text>
+    <text class="card-body" x="30" y="184">但会牵动几个页面</text>
+    <text class="card-body" x="30" y="216">状态或用户动作</text>
+    <text class="card-body" x="30" y="248">先用人话给 mini-plan</text>
+    <text class="card-body" x="30" y="280">方向对了再继续</text>
+  </g>
+
+  <g transform="translate(1084 220)" filter="url(#shadow)">
+    <rect width="420" height="280" rx="22" fill="#ffffff" stroke="#86efac" stroke-width="2"/>
+    <rect x="30" y="28" width="104" height="38" rx="19" fill="#16a34a"/>
+    <text class="pill" x="62" y="53">03</text>
+    <text class="card-title" x="30" y="108">新功能 / 新流程方案</text>
+    <text class="card-body" x="30" y="152">范围更大，角色更多</text>
+    <text class="card-body" x="30" y="184">或业务风险还不清楚</text>
+    <text class="card-body" x="30" y="216">先讲清用户场景</text>
+    <text class="card-body" x="30" y="248">第一版、不做什么</text>
+    <text class="card-body" x="30" y="280">再进入完整方案</text>
+  </g>
+
+  <path class="line" d="M516 360 H578"/>
+  <path class="line" d="M1010 360 H1072"/>
+
+  <g transform="translate(220 566)" filter="url(#shadow)">
+    <rect width="1160" height="156" rx="24" fill="#ffffff" stroke="#dbeafe" stroke-width="2"/>
+    <text class="footer-title" x="40" y="54">你只需要先说明业务问题</text>
+    <text class="footer-body" x="40" y="90">谁在什么场景下遇到什么问题，想先解决哪一块。</text>
+    <path class="dash" d="M420 78 H520"/>
+    <text class="footer-title" x="560" y="54">OpenPrd 先帮你归纳</text>
+    <text class="footer-body" x="560" y="90">先讲目标、范围、先不做什么，以及主要风险。</text>
+    <path class="dash" d="M936 78 H1036"/>
+    <text class="footer-title" x="1074" y="54">再选合适的推进节奏</text>
+    <text class="footer-body" x="1074" y="90">避免一上来就重流程，也避免没说清就直接开做。</text>
+  </g>
+
+  <g transform="translate(120 792)" filter="url(#shadow)">
+    <rect width="1360" height="110" rx="24" fill="#ffffff" stroke="#dbeafe" stroke-width="2"/>
+    <circle cx="72" cy="55" r="28" fill="#fb923c"/>
+    <circle cx="460" cy="55" r="28" fill="#38bdf8"/>
+    <circle cx="864" cy="55" r="28" fill="#34d399"/>
+    <text class="footer-title" x="118" y="44">个人用户场景</text>
+    <text class="footer-body" x="118" y="74">更关注什么时候会用、第一下有没有感受到价值。</text>
+    <text class="footer-title" x="506" y="44">团队 / 企业流程</text>
+    <text class="footer-body" x="506" y="74">更关注谁拍板、谁使用、谁要推进上线。</text>
+    <text class="footer-title" x="910" y="44">Agent 协作</text>
+    <text class="footer-body" x="910" y="74">更关注哪些能自动做、哪里必须人工兜底。</text>
+  </g>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openprd/cli",
-  "version": "0.1.1",
+  "version": "0.1.8",
   "description": "AI-native PRD workspace and lifecycle CLI",
   "type": "module",
   "license": "MIT",
@@ -11,6 +11,7 @@
     "AGENTS.md",
     "CONTRIBUTING.md",
     "README_CN.md",
+    "README_EN.md",
     "SECURITY.md",
     "bin",
     "docs/assets",
@@ -49,8 +50,11 @@
   },
   "scripts": {
     "start": "node ./bin/openprd.js",
+    "release:notes": "node scripts/openprd-github-release-notes.mjs",
     "test": "node --test",
-    "test:smoke": "node --test --test-name-pattern \"quality requires current smoke evidence|run exposes hook-stable\""
+    "test:smoke": "node --test --test-name-pattern \"quality requires current smoke evidence|run exposes hook-stable\"",
+    "test:perf": "node scripts/quality-perf-check.mjs --mode normal",
+    "test:perf:extreme": "node scripts/quality-perf-check.mjs --mode extreme --fixture test/fixtures/release-ledger-extreme.json"
   },
   "dependencies": {
     "sharp": "^0.34.5",

package/scripts/dev-check-wrapup-copy.mjs

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+export const DEV_CHECK_WRAPUP_COPY_LIMIT = 20;
+const WRAPUP_FIELDS = ['规模信号', '预警原因', '本次处理结果', '后续建议'];
+const VALIDATE_USAGE = 'Usage: echo \'{"rows":[{"影响对象":"src/example.js","规模信号":"701 行（> 700 行/文件）","预警原因":"文件偏大，维护成本升","本次处理结果":"本轮小改，未扩职责","后续建议":"继续改前先拆小"}]}\' | node scripts/dev-check-wrapup-copy.mjs --validate';
+
+function countChars(value) {
+  return Array.from(String(value ?? ''));
+}
+
+function validateCompactRows(rows = [], limit = DEV_CHECK_WRAPUP_COPY_LIMIT) {
+  for (const [index, row] of rows.entries()) {
+    const rowLabel = row?.影响对象 ? String(row.影响对象) : (row?.影响位置 ? String(row.影响位置) : `第 ${index + 1} 行`);
+    for (const field of WRAPUP_FIELDS) {
+      const value = row?.[field];
+      if (typeof value !== 'string') {
+        throw new Error(`后续建议校验失败：${rowLabel} 缺少字段“${field}”。${VALIDATE_USAGE}`);
+      }
+      const actual = countChars(value).length;
+      if (actual > limit) {
+        throw new Error(`后续建议校验失败：${rowLabel} 的“${field}”有 ${actual} 个字，超过 ${limit} 字上限。当前内容：“${value}”。请缩短后重试。`);
+      }
+    }
+  }
+}
+
+function formatLineCount(value) {
+  return value === null || value === undefined ? '未知行数' : `${value} 行`;
+}
+
+function thresholdText(file) {
+  const thresholds = file.thresholds ?? {};
+  const okMax = thresholds.okMax ?? 700;
+  const attentionMax = thresholds.attentionMax ?? 1500;
+  const lineText = formatLineCount(file.lineCount);
+  if (file.status === 'warning') {
+    return `${lineText}（> ${attentionMax} 行/文件）`;
+  }
+  if (file.status === 'attention') {
+    return `${lineText}（> ${okMax} 行/文件）`;
+  }
+  if (file.status === 'error') {
+    return `${lineText}（检查失败）`;
+  }
+  if (file.status === 'ok') {
+    return `${lineText}（范围内）`;
+  }
+  return lineText;
+}
+
+function reasonText(file) {
+  if (file.status === 'warning') return '文件太大，后续改动风险高';
+  if (file.status === 'attention') return '文件偏大，维护成本升';
+  if (file.status === 'error') return '检查失败，需先修复';
+  if (file.status === 'ok') return '暂无额外预警';
+  return '待补充';
+}
+
+function currentResultText(file) {
+  if (file.status === 'warning') return '这次先完成需求，暂不拆分';
+  if (file.status === 'attention') return '本轮小改，未扩职责';
+  if (file.status === 'error') return '本轮失败，未收口';
+  if (file.status === 'ok') return '本轮已回顾';
+  return '待确认';
+}
+
+function followUpText(file) {
+  if (file.status === 'warning') return '优先拆出独立职责';
+  if (file.status === 'attention') return '继续改前先拆小';
+  if (file.status === 'error') return '先修复后重跑';
+  if (file.status === 'ok') return '无需额外动作';
+  return '待确认';
+}
+
+export function buildCompactDevCheckWrapUpRows(files = []) {
+  return files.map((file) => ({
+    规模信号: thresholdText(file),
+    预警原因: reasonText(file),
+    本次处理结果: currentResultText(file),
+    后续建议: followUpText(file),
+  }));
+}
+
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString('utf8');
+}
+
+async function main() {
+  const validateOnly = process.argv.includes('--validate');
+  const raw = await readStdin();
+  const payload = raw.trim() ? JSON.parse(raw) : {};
+  const rows = validateOnly
+    ? (Array.isArray(payload.rows) ? payload.rows : [])
+    : buildCompactDevCheckWrapUpRows(Array.isArray(payload.files) ? payload.files : []);
+  validateCompactRows(rows);
+  process.stdout.write(JSON.stringify({
+    ok: true,
+    limit: DEV_CHECK_WRAPUP_COPY_LIMIT,
+    rows,
+  }));
+}
+
+main().catch((error) => {
+  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+  process.exitCode = 1;
+});

package/scripts/openprd-github-release-notes.mjs

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { buildGitHubReleasePayload, writeGitHubReleaseNotes } from '../src/github-release.js';
+
+function printHelp() {
+  console.log([
+    'Usage: node scripts/openprd-github-release-notes.mjs [projectRoot] [options]',
+    '',
+    'Options:',
+    '  --version <x.y.z>   Expected project version. Defaults to package.json version.',
+    '  --tag <tag>         Git tag to publish, for example v0.1.23.',
+    '  --title <text>      Override the GitHub Release title.',
+    '  --out <file>        Write the rendered markdown to a file instead of stdout.',
+    '  --json              Print the structured payload as JSON.',
+    '  --help              Show this help message.',
+  ].join('\n'));
+}
+
+function parseArgs(argv) {
+  const args = [...argv];
+  const result = {
+    projectRoot: '.',
+    version: '',
+    tag: '',
+    title: '',
+    out: '',
+    json: false,
+    help: false,
+  };
+
+  if (args[0] && !args[0].startsWith('--')) {
+    result.projectRoot = args.shift();
+  }
+
+  while (args.length > 0) {
+    const arg = args.shift();
+    if (arg === '--help') {
+      result.help = true;
+      continue;
+    }
+    if (arg === '--json') {
+      result.json = true;
+      continue;
+    }
+    if (['--version', '--tag', '--title', '--out'].includes(arg)) {
+      const value = args.shift();
+      if (!value) {
+        throw new Error(`Missing value for ${arg}.`);
+      }
+      result[arg.slice(2)] = value;
+      continue;
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+
+  result.projectRoot = path.resolve(result.projectRoot);
+  return result;
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help) {
+    printHelp();
+    return;
+  }
+
+  const options = {
+    version: args.version || undefined,
+    tag: args.tag || undefined,
+    title: args.title || undefined,
+    out: args.out || undefined,
+  };
+  const result = args.out
+    ? await writeGitHubReleaseNotes(args.projectRoot, options)
+    : await buildGitHubReleasePayload(args.projectRoot, options);
+
+  if (!result.ok) {
+    console.error(result.error);
+    process.exitCode = 1;
+    return;
+  }
+
+  if (args.json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  if (args.out) {
+    console.log(result.out);
+    return;
+  }
+
+  console.log(result.markdown);
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+});

package/scripts/quality-perf-check.mjs

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import process from 'node:process';
+import { performance } from 'node:perf_hooks';
+
+import {
+  appendReleaseEntry,
+  buildReleaseChangeSummary,
+  buildReleaseLedgerSummary,
+  defaultReleaseLedger,
+  normalizeReleaseLedger,
+  setCurrentReleaseVersion,
+} from '../src/release-ledger.js';
+import { buildChangeSummaryFromEntries } from '../src/change-summary.js';
+
+const MB = 1024 * 1024;
+
+function parseArgs(argv) {
+  const options = {
+    mode: 'normal',
+    fixture: null,
+  };
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === '--mode' && argv[index + 1]) {
+      options.mode = argv[index + 1];
+      index += 1;
+      continue;
+    }
+    if (arg === '--fixture' && argv[index + 1]) {
+      options.fixture = argv[index + 1];
+      index += 1;
+    }
+  }
+  return options;
+}
+
+function percentile(values, ratio) {
+  if (!values.length) return 0;
+  const sorted = [...values].sort((a, b) => a - b);
+  const index = Math.min(sorted.length - 1, Math.max(0, Math.ceil(sorted.length * ratio) - 1));
+  return sorted[index];
+}
+
+function formatNumber(value) {
+  return Number(value).toFixed(2);
+}
+
+function isoTimestamp() {
+  return new Date().toISOString();
+}
+
+async function readQualityBaseline(mode) {
+  const configPath = path.resolve('.openprd/quality/config.json');
+  const config = JSON.parse(await fs.readFile(configPath, 'utf8'));
+  return mode === 'extreme'
+    ? config.evalHarness?.projectBaseline?.extreme
+    : config.evalHarness?.projectBaseline?.normal;
+}
+
+async function readFixtureConfig(mode, fixturePath) {
+  if (mode !== 'extreme' || !fixturePath) {
+    return {
+      versionCount: 6,
+      itemsPerVersion: 18,
+      detailRepeats: 2,
+      iterations: 180,
+      limit: 12,
+    };
+  }
+  const fullPath = path.resolve(fixturePath);
+  const raw = JSON.parse(await fs.readFile(fullPath, 'utf8'));
+  return {
+    versionCount: Number(raw.versionCount ?? 24),
+    itemsPerVersion: Number(raw.itemsPerVersion ?? 36),
+    detailRepeats: Number(raw.detailRepeats ?? 6),
+    iterations: Number(raw.iterations ?? 140),
+    limit: Number(raw.limit ?? 16),
+  };
+}
+
+function buildSentence(versionIndex, itemIndex, detailRepeats) {
+  const verbs = ['新增', '修复', '优化', '调整', '移除'];
+  const verb = verbs[(versionIndex + itemIndex) % verbs.length];
+  const topic = `版本轨道变更 ${versionIndex + 1}-${itemIndex + 1}`;
+  const detail = Array.from({ length: detailRepeats }, (_, index) => `${topic} 说明片段 ${index + 1}`).join('，');
+  return `${verb}${topic}，${detail}`;
+}
+
+function buildVersion(versionIndex) {
+  const major = 0;
+  const minor = Math.floor(versionIndex / 10) + 1;
+  const patch = (versionIndex % 10) + 1;
+  return `${major}.${minor}.${patch}`;
+}
+
+async function buildLedger(config) {
+  let ledger = {
+    ...defaultReleaseLedger(),
+    enabled: true,
+  };
+  for (let versionIndex = 0; versionIndex < config.versionCount; versionIndex += 1) {
+    const version = buildVersion(versionIndex);
+    ({ ledger } = setCurrentReleaseVersion(ledger, version));
+    for (let itemIndex = 0; itemIndex < config.itemsPerVersion; itemIndex += 1) {
+      ({ ledger } = appendReleaseEntry(ledger, buildSentence(versionIndex, itemIndex, config.detailRepeats), {
+        version,
+        source: {
+          kind: 'perf-fixture',
+          versionIndex,
+          itemIndex,
+        },
+      }));
+    }
+  }
+  return normalizeReleaseLedger(ledger);
+}
+
+function runBenchmark(ledger, config) {
+  const durations = [];
+  const heapSamples = [];
+  const startHeap = process.memoryUsage().heapUsed / MB;
+  for (let index = 0; index < config.iterations; index += 1) {
+    const startedAt = performance.now();
+    const summary = buildReleaseLedgerSummary(ledger);
+    const changeSummary = buildReleaseChangeSummary(ledger, {
+      version: summary.currentVersion,
+      limit: config.limit,
+    });
+    buildChangeSummaryFromEntries(changeSummary.items, { limit: config.limit });
+    durations.push(performance.now() - startedAt);
+    heapSamples.push(process.memoryUsage().heapUsed / MB);
+  }
+  const endHeap = process.memoryUsage().heapUsed / MB;
+  return {
+    iterations: durations.length,
+    p50Ms: percentile(durations, 0.5),
+    p95Ms: percentile(durations, 0.95),
+    maxMs: Math.max(...durations),
+    avgMs: durations.reduce((sum, value) => sum + value, 0) / durations.length,
+    startHeapMB: startHeap,
+    endHeapMB: endHeap,
+    peakHeapMB: Math.max(...heapSamples, endHeap),
+    heapDeltaMB: endHeap - startHeap,
+  };
+}
+
+async function writeReport(mode, fixtureConfig, baseline, metrics) {
+  const reportDir = path.resolve('.openprd/harness/test-reports');
+  await fs.mkdir(reportDir, { recursive: true });
+  const reportPath = path.join(reportDir, `quality-${mode}-performance.md`);
+  const title = mode === 'extreme' ? 'EVO Extreme Performance Report' : 'EVO Normal Performance Report';
+  const lines = [
+    `# ${title}`,
+    '',
+    `- generatedAt: ${isoTimestamp()}`,
+    `- mode: ${mode}`,
+    `- performance: p50 ${formatNumber(metrics.p50Ms)}ms, p95 ${formatNumber(metrics.p95Ms)}ms, max ${formatNumber(metrics.maxMs)}ms`,
+    `- latency baseline: p95 <= ${baseline.apiLatencyMsP95Max}ms`,
+    `- memory baseline: peak <= ${baseline.memoryMBP95Max}MB`,
+    `- memory: start ${formatNumber(metrics.startHeapMB)}MB, peak ${formatNumber(metrics.peakHeapMB)}MB, delta ${formatNumber(metrics.heapDeltaMB)}MB`,
+    `- dataset: ${fixtureConfig.versionCount} versions x ${fixtureConfig.itemsPerVersion} items`,
+    mode === 'extreme'
+      ? `- extreme: fixture-driven load passed with ${fixtureConfig.detailRepeats} repeated detail fragments per item`
+      : '- performance: baseline ledger summary path remained within project limits',
+    '',
+  ];
+  await fs.writeFile(reportPath, `${lines.join('\n')}\n`, 'utf8');
+  return reportPath;
+}
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  const [baseline, fixtureConfig] = await Promise.all([
+    readQualityBaseline(options.mode),
+    readFixtureConfig(options.mode, options.fixture),
+  ]);
+  const ledger = await buildLedger(fixtureConfig);
+  const metrics = runBenchmark(ledger, fixtureConfig);
+  const withinLatency = metrics.p95Ms <= Number(baseline.apiLatencyMsP95Max ?? 500);
+  const withinMemory = metrics.peakHeapMB <= Number(baseline.memoryMBP95Max ?? 512);
+  const reportPath = await writeReport(options.mode, fixtureConfig, baseline, metrics);
+  const result = {
+    ok: withinLatency && withinMemory,
+    mode: options.mode,
+    reportPath,
+    dataset: {
+      versionCount: fixtureConfig.versionCount,
+      itemsPerVersion: fixtureConfig.itemsPerVersion,
+      detailRepeats: fixtureConfig.detailRepeats,
+    },
+    metrics,
+    baseline,
+  };
+  console.log(JSON.stringify(result, null, 2));
+  if (!result.ok) {
+    process.exitCode = 1;
+  }
+}
+
+await main();

package/skills/openprd-benchmark-router/SKILL.md

@@ -40,6 +40,7 @@ description: 为 OpenPrd 产品、CLI、Agent harness、AI code review / PR revi
 - 项目自己的 `.openprd/benchmarks/` 优先于 OpenPrd 内置 Source Map。
 - `sources.yaml` 里的 approved source 是长期可复用参考；`inbox/` 里的 candidate 只表示待确认线索。
 - 用 `openprd benchmark add <url|repo|file>` 写入 candidate，用 `openprd benchmark approve <id>` 纳入 approved registry。
+- 执行或复盘中发现被用户采纳的优质信源时，用 `openprd benchmark observe <url|repo|file> --notes <text>` 累计 evidence；达到阈值后只推荐 approve，不自动晋级。
 - 用 `openprd benchmark verify` 检查重复来源、失效链接、缺失本地文件和过宽触发规则。
 
 ## Source Policy