@epoint-testtech/ep-stage-skill 0.0.15 → 0.0.17

package/dist/src/cli/run-report.js

@@ -121,26 +121,36 @@ function renderTestCard(item, strategy, caseId) {
     const errorHtml = item.errorMessage
         ? `<div class="error"><strong>错误信息：</strong><pre>${escapeHtml(item.errorMessage)}</pre></div>`
         : '';
-    return `
-    <article class="workflow workflow--${escapeHtml(STATUS_BADGE_CLASS[item.status])}" data-strategy="${escapeHtml(strategy)}" data-status="${escapeHtml(item.status)}">
-      <header class="workflow__header">
-        <div class="workflow__title">
-          <h2>${escapeHtml(item.title)}</h2>
-          <code class="workflow__id">${escapeHtml(item.location ?? '')}</code>
-        </div>
-        <div class="workflow__meta">
-          <span class="badge badge--kind">${escapeHtml(item.projectName)}</span>
-          <span class="badge badge--source">${escapeHtml(strategy === 'agent_inferred' ? 'Agent推理执行' : '胶水编码执行')}</span>
-          <span class="badge badge--status badge--${escapeHtml(STATUS_BADGE_CLASS[item.status])}">${escapeHtml(STATUS_LABEL[item.status])}</span>
-        </div>
-      </header>
-      <dl class="workflow__body">
-        ${caseId ? `<dt>用例ID</dt><dd><code>${escapeHtml(caseId)}</code></dd>` : ''}
-        <dt>套件路径</dt><dd>${escapeHtml(item.suitePath)}</dd>
-        <dt>耗时</dt><dd>${escapeHtml(formatDuration(item.durationMs))}</dd>
-      </dl>
-      ${errorHtml}
-    </article>
+    // 骨架运行时有复核结论（reviewNote）时覆盖呈现为「待审阅」：
+    // Playwright 层 passed 只代表脚本无异常，业务语义（如过滤是否生效）未验证。
+    const needsReview = Boolean(item.reviewNote);
+    const statusBadge = needsReview
+        ? '<span class="badge badge--status badge--needs_review">待审阅</span>'
+        : `<span class="badge badge--status badge--${escapeHtml(STATUS_BADGE_CLASS[item.status])}">${escapeHtml(STATUS_LABEL[item.status])}</span>`;
+    const reviewHtml = needsReview
+        ? `<div class="review"><strong>审阅原因：</strong>${escapeHtml(item.reviewNote)}</div>`
+        : '';
+    return `
+    <article class="workflow workflow--${escapeHtml(needsReview ? 'needs_review' : STATUS_BADGE_CLASS[item.status])}" data-strategy="${escapeHtml(strategy)}" data-status="${escapeHtml(needsReview ? 'needs_review' : item.status)}">
+      <header class="workflow__header">
+        <div class="workflow__title">
+          <h2>${escapeHtml(item.title)}</h2>
+          <code class="workflow__id">${escapeHtml(item.location ?? '')}</code>
+        </div>
+        <div class="workflow__meta">
+          <span class="badge badge--kind">${escapeHtml(item.projectName)}</span>
+          <span class="badge badge--source">${escapeHtml(strategy === 'agent_inferred' ? 'Agent推理执行' : '胶水编码执行')}</span>
+          ${statusBadge}
+        </div>
+      </header>
+      <dl class="workflow__body">
+        ${caseId ? `<dt>用例ID</dt><dd><code>${escapeHtml(caseId)}</code></dd>` : ''}
+        <dt>套件路径</dt><dd>${escapeHtml(item.suitePath)}</dd>
+        <dt>耗时</dt><dd>${escapeHtml(formatDuration(item.durationMs))}</dd>
+      </dl>
+      ${errorHtml}
+      ${reviewHtml}
+    </article>
   `;
 }
 /**
@@ -178,17 +188,20 @@ export function renderRunReportHtml(data) {
         ['胶水编码执行', data.items.length - agentCount, 'glue', 'glue_code'],
         ['Agent推理执行', agentCount, 'agent', 'agent_inferred'],
     ];
+    const reviewCount = data.items.filter((i) => i.reviewNote).length;
     const resultCards = [
-        ['通过', count('passed'), 'passed', 'passed'],
+        // 「通过」只计无复核标记的干净通过；带 reviewNote 的归入「待审阅」，避免双重计数
+        ['通过', data.items.filter((i) => i.status === 'passed' && !i.reviewNote).length, 'passed', 'passed'],
         ['失败', count('failed'), 'failed', 'failed'],
-        ['不稳定', count('flaky'), 'review', 'flaky'],
-        ['跳过', count('skipped'), 'unresolved', 'skipped'],
+        ['待审阅', reviewCount, 'review', 'needs_review'],
+        ['不稳定', data.items.filter((i) => i.status === 'flaky' && !i.reviewNote).length, 'review', 'flaky'],
+        ['跳过', data.items.filter((i) => i.status === 'skipped' && !i.reviewNote).length, 'unresolved', 'skipped'],
     ];
     const renderCards = (cards, filterGroup) => cards
-        .map(([label, value, kind, filterValue]) => `
-        <div class="summary-card summary-card--${kind}" data-filter-group="${filterGroup}" data-filter-value="${filterValue}" role="button" tabindex="0">
-          <div class="summary-card__value">${value}</div>
-          <div class="summary-card__label">${escapeHtml(label)}</div>
+        .map(([label, value, kind, filterValue]) => `
+        <div class="summary-card summary-card--${kind}" data-filter-group="${filterGroup}" data-filter-value="${filterValue}" role="button" tabindex="0">
+          <div class="summary-card__value">${value}</div>
+          <div class="summary-card__label">${escapeHtml(label)}</div>
         </div>`)
         .join('');
     const workflowsHtml = sortedItems.length
@@ -206,126 +219,127 @@ export function renderRunReportHtml(data) {
     ]
         .filter(Boolean)
         .join(' ');
-    const style = `
-    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif; background: #f7f8fa; color: #1f2933; margin: 0; padding: 24px; }
-    h1 { margin: 0 0 16px; font-size: 22px; }
-    h2 { font-size: 16px; margin: 16px 0 8px; }
-    section.overview { background: #fff; border-radius: 8px; padding: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.05); margin-bottom: 24px; }
-    .overview-table { width: 100%; border-collapse: collapse; margin-bottom: 16px; }
-    .overview-table th, .overview-table td { text-align: left; padding: 6px 12px; border-bottom: 1px solid #eee; font-size: 13px; }
-    .overview-table th { width: 140px; color: #52606d; font-weight: 600; }
-    .summary-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(140px, 1fr)); gap: 12px; }
-    .summary-card { background: #f0f4f8; border-radius: 6px; padding: 12px; text-align: center; cursor: pointer; transition: box-shadow 0.15s, transform 0.1s; }
-    .summary-card:hover { box-shadow: 0 2px 6px rgba(0,0,0,0.1); transform: translateY(-1px); }
-    .summary-card--active { box-shadow: 0 0 0 2px #2563eb; }
-    .summary-card__value { font-size: 22px; font-weight: 600; }
-    .summary-card__label { font-size: 12px; color: #52606d; margin-top: 4px; }
-    .summary-card--passed { background: #e3fcec; }
-    .summary-card--failed { background: #ffe3e3; }
-    .summary-card--review { background: #fff4d6; }
-    .summary-card--unresolved { background: #f0e8ff; }
-    article.workflow { background: #fff; border-radius: 8px; padding: 16px 20px; margin-bottom: 16px; box-shadow: 0 1px 3px rgba(0,0,0,0.05); border-left: 4px solid #cbd2d9; }
-    article.workflow--passed { border-left-color: #2f9e44; }
-    article.workflow--failed { border-left-color: #e03131; }
-    article.workflow--needs_review { border-left-color: #f59f00; }
-    article.workflow--unresolved { border-left-color: #7048e8; }
-    .workflow__header { display: flex; justify-content: space-between; align-items: flex-start; flex-wrap: wrap; gap: 12px; }
-    .workflow__title h2 { margin: 0; font-size: 16px; }
-    .workflow__id { font-size: 12px; color: #52606d; }
-    .workflow__meta { display: flex; gap: 8px; flex-wrap: wrap; }
-    .badge { display: inline-block; padding: 2px 8px; font-size: 12px; border-radius: 12px; background: #e4e7eb; color: #1f2933; }
-    .badge--passed { background: #2f9e44; color: #fff; }
-    .badge--failed { background: #e03131; color: #fff; }
-    .badge--needs_review { background: #f59f00; color: #fff; }
-    .badge--unresolved { background: #7048e8; color: #fff; }
-    dl.workflow__body { display: grid; grid-template-columns: 100px 1fr; gap: 6px 12px; margin: 12px 0 4px; font-size: 13px; }
-    dl.workflow__body dt { color: #52606d; font-weight: 600; }
-    code { background: #f0f4f8; padding: 1px 4px; border-radius: 3px; font-size: 12px; }
-    .error pre { background: #fff5f5; color: #c92a2a; padding: 8px; border-radius: 4px; overflow-x: auto; font-size: 12px; white-space: pre-wrap; }
-    .muted { color: #829ab1; font-size: 13px; }
-    footer.footer { background: #fff; border-radius: 8px; padding: 16px 20px; margin-top: 16px; box-shadow: 0 1px 3px rgba(0,0,0,0.05); }
-    .pw-link { display: inline-block; padding: 8px 16px; background: #2563eb; color: #fff; border-radius: 4px; text-decoration: none; font-size: 14px; margin-right: 8px; }
-    .pw-link:hover { background: #1d4ed8; }
-    .pw-link--secondary { background: #334e68; }
-    .workflow-toolbar { display: flex; align-items: center; justify-content: space-between; gap: 12px; flex-wrap: wrap; margin: 16px 0 8px; }
-    .workflow-toolbar h2 { margin: 0; }
-    .workflow-filters { display: flex; gap: 8px; }
-    .workflow-filters select { padding: 4px 8px; font-size: 13px; border: 1px solid #cbd2d9; border-radius: 4px; background: #fff; color: #1f2933; }
-    .summary-section-title { font-size: 13px; color: #52606d; margin: 12px 0 4px; font-weight: 600; }
+    const style = `
+    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif; background: #f7f8fa; color: #1f2933; margin: 0; padding: 24px; }
+    h1 { margin: 0 0 16px; font-size: 22px; }
+    h2 { font-size: 16px; margin: 16px 0 8px; }
+    section.overview { background: #fff; border-radius: 8px; padding: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.05); margin-bottom: 24px; }
+    .overview-table { width: 100%; border-collapse: collapse; margin-bottom: 16px; }
+    .overview-table th, .overview-table td { text-align: left; padding: 6px 12px; border-bottom: 1px solid #eee; font-size: 13px; }
+    .overview-table th { width: 140px; color: #52606d; font-weight: 600; }
+    .summary-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(140px, 1fr)); gap: 12px; }
+    .summary-card { background: #f0f4f8; border-radius: 6px; padding: 12px; text-align: center; cursor: pointer; transition: box-shadow 0.15s, transform 0.1s; }
+    .summary-card:hover { box-shadow: 0 2px 6px rgba(0,0,0,0.1); transform: translateY(-1px); }
+    .summary-card--active { box-shadow: 0 0 0 2px #2563eb; }
+    .summary-card__value { font-size: 22px; font-weight: 600; }
+    .summary-card__label { font-size: 12px; color: #52606d; margin-top: 4px; }
+    .summary-card--passed { background: #e3fcec; }
+    .summary-card--failed { background: #ffe3e3; }
+    .summary-card--review { background: #fff4d6; }
+    .summary-card--unresolved { background: #f0e8ff; }
+    article.workflow { background: #fff; border-radius: 8px; padding: 16px 20px; margin-bottom: 16px; box-shadow: 0 1px 3px rgba(0,0,0,0.05); border-left: 4px solid #cbd2d9; }
+    article.workflow--passed { border-left-color: #2f9e44; }
+    article.workflow--failed { border-left-color: #e03131; }
+    article.workflow--needs_review { border-left-color: #f59f00; }
+    article.workflow--unresolved { border-left-color: #7048e8; }
+    .workflow__header { display: flex; justify-content: space-between; align-items: flex-start; flex-wrap: wrap; gap: 12px; }
+    .workflow__title h2 { margin: 0; font-size: 16px; }
+    .workflow__id { font-size: 12px; color: #52606d; }
+    .workflow__meta { display: flex; gap: 8px; flex-wrap: wrap; }
+    .badge { display: inline-block; padding: 2px 8px; font-size: 12px; border-radius: 12px; background: #e4e7eb; color: #1f2933; }
+    .badge--passed { background: #2f9e44; color: #fff; }
+    .badge--failed { background: #e03131; color: #fff; }
+    .badge--needs_review { background: #f59f00; color: #fff; }
+    .badge--unresolved { background: #7048e8; color: #fff; }
+    dl.workflow__body { display: grid; grid-template-columns: 100px 1fr; gap: 6px 12px; margin: 12px 0 4px; font-size: 13px; }
+    dl.workflow__body dt { color: #52606d; font-weight: 600; }
+    code { background: #f0f4f8; padding: 1px 4px; border-radius: 3px; font-size: 12px; }
+    .error pre { background: #fff5f5; color: #c92a2a; padding: 8px; border-radius: 4px; overflow-x: auto; font-size: 12px; white-space: pre-wrap; }
+    .muted { color: #829ab1; font-size: 13px; }
+    footer.footer { background: #fff; border-radius: 8px; padding: 16px 20px; margin-top: 16px; box-shadow: 0 1px 3px rgba(0,0,0,0.05); }
+    .pw-link { display: inline-block; padding: 8px 16px; background: #2563eb; color: #fff; border-radius: 4px; text-decoration: none; font-size: 14px; margin-right: 8px; }
+    .pw-link:hover { background: #1d4ed8; }
+    .pw-link--secondary { background: #334e68; }
+    .workflow-toolbar { display: flex; align-items: center; justify-content: space-between; gap: 12px; flex-wrap: wrap; margin: 16px 0 8px; }
+    .workflow-toolbar h2 { margin: 0; }
+    .workflow-filters { display: flex; gap: 8px; }
+    .workflow-filters select { padding: 4px 8px; font-size: 13px; border: 1px solid #cbd2d9; border-radius: 4px; background: #fff; color: #1f2933; }
+    .summary-section-title { font-size: 13px; color: #52606d; margin: 12px 0 4px; font-weight: 600; }
   `;
-    return `<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width,initial-scale=1.0" />
-  <title>胶水编码-测试执行</title>
-  <style>${style}</style>
-</head>
-<body>
-  <section class="overview">
-    <h1>胶水编码-测试执行（综合报告）</h1>
-    <table class="overview-table">${overviewHtml}</table>
-    <h3 class="summary-section-title">执行策略</h3>
-    <div class="summary-grid summary-grid--strategy">${renderCards(strategyCards, 'strategy')}</div>
-    <h3 class="summary-section-title">执行结果</h3>
-    <div class="summary-grid summary-grid--result">${renderCards(resultCards, 'status')}</div>
-  </section>
-  <section class="workflows">
-    <div class="workflow-toolbar">
-      <h2>用例执行明细</h2>
-      <div class="workflow-filters">
-        <select id="filter-strategy">
-          <option value="">全部执行策略</option>
-          <option value="glue_code">胶水编码执行</option>
-          <option value="agent_inferred">Agent推理执行</option>
-        </select>
-        <select id="filter-status">
-          <option value="">全部执行结果</option>
-          <option value="passed">通过</option>
-          <option value="failed">失败</option>
-          <option value="flaky">不稳定</option>
-          <option value="skipped">跳过</option>
-        </select>
-      </div>
-    </div>
-    ${workflowsHtml}
-  </section>
-  <footer class="footer">
-    ${footerLinks || '<p class="muted">本次未发现关联报告产物</p>'}
-  </footer>
-  <script>
-    (function() {
-      var fs = document.getElementById('filter-strategy');
-      var fst = document.getElementById('filter-status');
-      var cards = document.querySelectorAll('article.workflow');
-      var summaryCards = document.querySelectorAll('.summary-card');
-      function apply() {
-        var s = fs.value, st = fst.value;
-        for (var i = 0; i < cards.length; i++) {
-          var c = cards[i];
-          var show = (!s || c.dataset.strategy === s) && (!st || c.dataset.status === st);
-          c.style.display = show ? '' : 'none';
-        }
-        for (var j = 0; j < summaryCards.length; j++) {
-          var card = summaryCards[j];
-          var select = card.dataset.filterGroup === 'strategy' ? fs : fst;
-          card.classList.toggle('summary-card--active', select.value !== '' && select.value === card.dataset.filterValue);
-        }
-      }
-      fs.addEventListener('change', apply);
-      fst.addEventListener('change', apply);
-      for (var j = 0; j < summaryCards.length; j++) {
-        (function(card) {
-          card.addEventListener('click', function() {
-            var select = card.dataset.filterGroup === 'strategy' ? fs : fst;
-            select.value = select.value === card.dataset.filterValue ? '' : card.dataset.filterValue;
-            apply();
-          });
-        })(summaryCards[j]);
-      }
-    })();
-  </script>
-</body>
-</html>
+    return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width,initial-scale=1.0" />
+  <title>胶水编码-测试执行</title>
+  <style>${style}</style>
+</head>
+<body>
+  <section class="overview">
+    <h1>胶水编码-测试执行（综合报告）</h1>
+    <table class="overview-table">${overviewHtml}</table>
+    <h3 class="summary-section-title">执行策略</h3>
+    <div class="summary-grid summary-grid--strategy">${renderCards(strategyCards, 'strategy')}</div>
+    <h3 class="summary-section-title">执行结果</h3>
+    <div class="summary-grid summary-grid--result">${renderCards(resultCards, 'status')}</div>
+  </section>
+  <section class="workflows">
+    <div class="workflow-toolbar">
+      <h2>用例执行明细</h2>
+      <div class="workflow-filters">
+        <select id="filter-strategy">
+          <option value="">全部执行策略</option>
+          <option value="glue_code">胶水编码执行</option>
+          <option value="agent_inferred">Agent推理执行</option>
+        </select>
+        <select id="filter-status">
+          <option value="">全部执行结果</option>
+          <option value="passed">通过</option>
+          <option value="failed">失败</option>
+          <option value="needs_review">待审阅</option>
+          <option value="flaky">不稳定</option>
+          <option value="skipped">跳过</option>
+        </select>
+      </div>
+    </div>
+    ${workflowsHtml}
+  </section>
+  <footer class="footer">
+    ${footerLinks || '<p class="muted">本次未发现关联报告产物</p>'}
+  </footer>
+  <script>
+    (function() {
+      var fs = document.getElementById('filter-strategy');
+      var fst = document.getElementById('filter-status');
+      var cards = document.querySelectorAll('article.workflow');
+      var summaryCards = document.querySelectorAll('.summary-card');
+      function apply() {
+        var s = fs.value, st = fst.value;
+        for (var i = 0; i < cards.length; i++) {
+          var c = cards[i];
+          var show = (!s || c.dataset.strategy === s) && (!st || c.dataset.status === st);
+          c.style.display = show ? '' : 'none';
+        }
+        for (var j = 0; j < summaryCards.length; j++) {
+          var card = summaryCards[j];
+          var select = card.dataset.filterGroup === 'strategy' ? fs : fst;
+          card.classList.toggle('summary-card--active', select.value !== '' && select.value === card.dataset.filterValue);
+        }
+      }
+      fs.addEventListener('change', apply);
+      fst.addEventListener('change', apply);
+      for (var j = 0; j < summaryCards.length; j++) {
+        (function(card) {
+          card.addEventListener('click', function() {
+            var select = card.dataset.filterGroup === 'strategy' ? fs : fst;
+            select.value = select.value === card.dataset.filterValue ? '' : card.dataset.filterValue;
+            apply();
+          });
+        })(summaryCards[j]);
+      }
+    })();
+  </script>
+</body>
+</html>
 `;
 }

package/dist/src/cli/run.d.ts

@@ -11,6 +11,8 @@ export type RunArgs = {
     testcase: string;
     headless: boolean;
     aiSnippets?: string;
+    /** true 时恢复旧语义：任一 AI 任务缺 resolved snippet 则整体短路不执行（默认 false = 部分执行） */
+    strictAi?: boolean;
 };
 /**
  * run 子命令产物（新协议 v1-draft）。
@@ -31,6 +33,8 @@ export type RunResult = {
     aiRuntimeTracePath?: string;
     repairReportPath?: string;
     comprehensiveReportPath?: string;
+    /** 部分执行语义下未执行（needs_review）的 AI 任务数；0/undefined = 全部任务已就绪 */
+    needsReviewCount?: number;
 };
 /**
  * runRun 的可注入依赖（测试即契约：允许单测替换推理与执行，避免触发真机）。
@@ -132,6 +136,21 @@ export declare function loadAiSnippets(input: {
     testcasePath: string;
     tasks: AiRuntimeTask[];
 }): AiRuntimeResult[];
+/**
+ * 读取 Agent 在 ai-snippets.json5 中自评的 needs_review 结论。
+ *
+ * 与 loadAiSnippets 互补：resolved 走 spec 合并，needs_review 走 trace/报告透传——
+ * Agent 的差异化复审证据（reviewReason / observation / evidence）必须保留，
+ * 不得被 CLI 占位文本覆盖。
+ *
+ * @param input - snippets 路径、testcase 路径和当前 AI tasks。
+ * @returns Agent 自评 needs_review 的 AiRuntimeResult 列表。
+ */
+export declare function loadAiSnippetReviewResults(input: {
+    snippetsPath: string;
+    testcasePath: string;
+    tasks: AiRuntimeTask[];
+}): AiRuntimeResult[];
 /**
  * 从 testcase 构建 AI Runtime Task 列表。
  *
@@ -151,6 +170,38 @@ export declare function buildAiRuntimeTasks(testcase: EpStageTestcaseV1Draft, pa
  * @returns trace 路径、spec 路径和任务摘要。
  */
 export declare function prepareAiRuntimeTasks(testcasePath: string): PrepareAiRuntimeTasksResult;
+/**
+ * run 执行前置凭据门禁。
+ *
+ * 背景：glue 骨架运行时（stage-core loadCredentials / spec 内 `credential.url`）只读
+ * `url / username / password`；credentials.json5 只写 loginUrl 时 CLI 侧宽松校验能过，
+ * 却要等到骨架 `page.goto(undefined)` 才爆。这里在执行 Playwright 前显式拦截：
+ * 文件存在则每条必须 url / username / password 非空（validateCredentials 先保证结构
+ * 与 username/password，本门禁再强制 url 字段本身存在）。
+ * 文件缺失仍走 credentialsNotice 软提示（保持既有行为，由 skill Step 3 引导补齐）。
+ *
+ * @param testcase - 已校验 testcase。
+ * @param testcasePath - testcase.json5 绝对路径。
+ */
+export declare function assertRunCredentialsReady(testcase: EpStageTestcaseV1Draft, testcasePath: string): void;
+/**
+ * 从项目 glue-report 下最新的 stage-glue 执行记录 JSON 提取复核结论映射。
+ *
+ * 与 run 的关系：recorder 由 spec 内 afterAll 在 Playwright 进程内写出
+ * （glue-report/<执行时间戳>/stage-glue-<时间戳>.json），本函数在 Playwright 结束后调用。
+ *
+ * 串轮防线：只消费「本轮执行」产生的记录。最新目录的 JSON startedAt 早于
+ * executionStartedAt（含 30s 时钟容差）时说明本轮 recorder 未落盘（如执行在
+ * afterAll 前崩溃），直接返回空 Map——严禁回退到上一轮目录，否则历史复核结论
+ * （如「搜索前后数据量相同」）会贴到本轮已通过用例的卡片上。
+ *
+ * 任一环节缺失（目录/文件/结构不符）返回空 Map——综合报告退化为仅 Playwright 视角，不阻断。
+ *
+ * @param projectDir - glue 项目根目录。
+ * @param executionStartedAt - 本轮 Playwright 启动时刻（早于 executor 调用采集）。
+ * @returns playwrightTestTitle → 复核原因（仅 needs_review 工作流）。
+ */
+export declare function loadRecorderReviewNotes(projectDir: string, executionStartedAt: Date): Map<string, string>;
 /**
  * run 子命令主体（REQ-CHAIN-02 / REQ-SPEC-01，新协议 v1-draft）。
  *

package/dist/src/cli/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/run.ts"],"names":[],"mappings":"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"}