@epoint-testtech/ep-stage-skill 0.0.10 → 0.5.0-alpha.2

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

@@ -1,331 +0,0 @@
-/**
- * run-report.ts — run 子命令的综合报告渲染（glue 风格单文件 HTML）。
- *
- * 输入：Playwright JSON reporter 产物（PLAYWRIGHT_JSON_OUTPUT_NAME 指定落盘）。
- * 输出：<reportDir>/index.html —— 与脚手架 stage-glue 报告同款样式
- * （概览 + 统计卡片 + 状态色卡片 + 页脚原生报告入口），
- * 但数据来自 Playwright 真实执行结果（覆盖全部用例，含 AI snippet）。
- */
-function escapeHtml(value) {
-    return value
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
-/** Playwright 错误文本含终端 ANSI 颜色码，写进 HTML 前必须剥掉。 */
-function stripAnsi(value) {
-    // eslint-disable-next-line no-control-regex
-    return value.replace(/\[[0-9;]*m/g, '');
-}
-function mapTestStatus(status) {
-    switch (status) {
-        case 'expected':
-            return 'passed';
-        case 'unexpected':
-            return 'failed';
-        case 'flaky':
-            return 'flaky';
-        default:
-            return 'skipped';
-    }
-}
-/**
- * 把 Playwright JSON reporter 输出摊平为报告用例条目。
- */
-export function parsePlaywrightJsonResults(jsonText) {
-    const parsed = JSON.parse(jsonText);
-    const items = [];
-    const walk = (suite, trail) => {
-        const nextTrail = suite.title ? [...trail, suite.title] : trail;
-        for (const spec of suite.specs ?? []) {
-            for (const test of spec.tests ?? []) {
-                const lastResult = test.results?.[test.results.length - 1];
-                const errorMessage = lastResult?.error?.message ?? lastResult?.errors?.[0]?.message;
-                items.push({
-                    title: spec.title,
-                    suitePath: nextTrail.join(' › '),
-                    projectName: test.projectName ?? '',
-                    status: mapTestStatus(test.status),
-                    durationMs: lastResult?.duration ?? 0,
-                    location: spec.file !== undefined && spec.line !== undefined
-                        ? `${spec.file}:${spec.line}`
-                        : spec.file,
-                    errorMessage: errorMessage
-                        ? stripAnsi(errorMessage).split('\n').slice(0, 12).join('\n')
-                        : undefined,
-                });
-            }
-        }
-        for (const child of suite.suites ?? []) {
-            walk(child, nextTrail);
-        }
-    };
-    for (const suite of parsed.suites ?? []) {
-        walk(suite, []);
-    }
-    return {
-        suiteTitle: parsed.suites?.[0]?.title ?? 'Playwright 测试套件',
-        durationMs: Math.round(parsed.stats?.duration ?? 0),
-        startedAt: parsed.stats?.startTime ?? '',
-        items,
-    };
-}
-const STATUS_LABEL = {
-    passed: '通过',
-    failed: '失败',
-    flaky: '不稳定',
-    skipped: '跳过',
-};
-const STATUS_BADGE_CLASS = {
-    passed: 'passed',
-    failed: 'failed',
-    flaky: 'needs_review',
-    skipped: 'unresolved',
-};
-function formatDuration(ms) {
-    if (ms >= 60_000) {
-        return `${Math.floor(ms / 60_000)}m ${Math.round((ms % 60_000) / 1000)}s`;
-    }
-    if (ms >= 1000) {
-        return `${(ms / 1000).toFixed(1)}s`;
-    }
-    return `${ms}ms`;
-}
-function formatDisplayTimestamp(iso) {
-    if (!iso)
-        return '-';
-    const d = new Date(iso);
-    if (Number.isNaN(d.getTime()))
-        return iso;
-    const pad = (n) => String(n).padStart(2, '0');
-    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
-}
-/** 解析用例ID：标题前缀（TC01001 …）优先，其次按 AI 任务标题匹配。 */
-function resolveCaseId(item, aiTasks) {
-    const prefix = item.title.match(/^([A-Z]{1,6}\d+)\s/)?.[1];
-    if (prefix)
-        return prefix;
-    return aiTasks.find((task) => task.title === item.title)?.caseId;
-}
-/** 判定执行策略：标题带用例ID前缀且该 ID 属于 AI 任务，或标题与 AI 任务相同 → Agent 推理。 */
-function resolveStrategy(item, aiTasks) {
-    const caseId = resolveCaseId(item, aiTasks);
-    if (caseId && aiTasks.some((task) => task.caseId === caseId))
-        return 'agent_inferred';
-    if (aiTasks.some((task) => task.title === item.title))
-        return 'agent_inferred';
-    return 'glue_code';
-}
-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>
-  `;
-}
-/**
- * 渲染 glue 风格综合报告（单文件、内联样式、无外部依赖）。
- */
-export function renderRunReportHtml(data) {
-    const count = (s) => data.items.filter((i) => i.status === s).length;
-    const agentCount = data.items.filter((i) => resolveStrategy(i, data.aiTasks) === 'agent_inferred').length;
-    // 卡片按用例ID 数字序排列（TC01001→TC01015），与 testcase.json5 顺序一致，便于人工对照；
-    // Playwright JSON 结果树的原始顺序是「外层 suite 直接 specs 在前、子 describe 在后」，不符合审阅习惯。
-    const sortedItems = [...data.items].sort((a, b) => {
-        const idA = resolveCaseId(a, data.aiTasks);
-        const idB = resolveCaseId(b, data.aiTasks);
-        const numA = idA ? Number(idA.replace(/^\D+/, '')) : Number.NaN;
-        const numB = idB ? Number(idB.replace(/^\D+/, '')) : Number.NaN;
-        if (Number.isNaN(numA) && Number.isNaN(numB))
-            return 0;
-        if (Number.isNaN(numA))
-            return 1;
-        if (Number.isNaN(numB))
-            return -1;
-        return numA - numB;
-    });
-    const overviewRows = [
-        ['测试套件', data.suiteTitle],
-        ['执行时间', formatDisplayTimestamp(data.startedAt)],
-        ['执行耗时', formatDuration(data.durationMs)],
-        ['Spec 文件', data.specFile ?? '-'],
-    ];
-    const overviewHtml = overviewRows
-        .map(([label, value]) => `<tr><th>${escapeHtml(label)}</th><td>${escapeHtml(value)}</td></tr>`)
-        .join('');
-    const strategyCards = [
-        ['总测试流程', data.items.length, 'total', ''],
-        ['胶水编码执行', data.items.length - agentCount, 'glue', 'glue_code'],
-        ['Agent推理执行', agentCount, 'agent', 'agent_inferred'],
-    ];
-    const resultCards = [
-        ['通过', count('passed'), 'passed', 'passed'],
-        ['失败', count('failed'), 'failed', 'failed'],
-        ['不稳定', count('flaky'), 'review', 'flaky'],
-        ['跳过', count('skipped'), '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>
-        </div>`)
-        .join('');
-    const workflowsHtml = sortedItems.length
-        ? sortedItems
-            .map((item) => renderTestCard(item, resolveStrategy(item, data.aiTasks), resolveCaseId(item, data.aiTasks)))
-            .join('\n')
-        : '<p class="muted">（本次运行未发现任何用例结果）</p>';
-    const footerLinks = [
-        data.playwrightReportHref
-            ? `<a class="pw-link" href="${escapeHtml(data.playwrightReportHref)}" target="_blank" rel="noopener">Playwright 原生报告（trace / 截图 / 视频）</a>`
-            : '',
-        data.stageReportHref
-            ? `<a class="pw-link pw-link--secondary" href="${escapeHtml(data.stageReportHref)}" target="_blank" rel="noopener">stage-core 流程报告（PDF）</a>`
-            : '',
-    ]
-        .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; }
-  `;
-    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>
-`;
-}

package/dist/src/extractors/prd-extractor.d.ts

@@ -1,70 +0,0 @@
-/**
- * PRD markdown 解析器。
- *
- * 职责：
- * 1. 在需求目录中发现 PRD markdown 文件。
- * 2. 解析 PRD 章节 4.1（功能列表）和 4.2.x（功能详细说明）。
- * 3. 输出结构化的 PrdFunctionEntry[]，供 testcase 装配阶段确定性使用。
- *
- * 设计取舍：
- * - 全程使用正则/行解析，不调用 LLM，保证幂等性。
- * - 只识别当前观察到的 PRD 结构（`4.1` 表格 + `4.2.x` 子章节 + 粗体字段标题）。
- * - 解析失败时返回空数组并在 inferenceTrace 中记录，不阻断 pipeline。
- */
-/** PRD 中的单个功能条目。 */
-export type PrdFunctionEntry = {
-    /** 功能编号，如 F001。 */
-    featureId: string;
-    /** 功能名称，如「同步窗口管理系统」。 */
-    featureName: string;
-    /** 功能模块，如「大厅地址管理」。 */
-    featureModule?: string;
-    /** 功能描述。 */
-    description: string;
-    /** 输入条件。 */
-    inputConditions?: string;
-    /** 处理逻辑，保留列表顺序。 */
-    processingLogic: string[];
-    /** 输出结果，保留列表顺序。 */
-    outputResult: string[];
-    /** 业务规则，保留列表顺序。 */
-    businessRules: string[];
-    /** 约束条件，保留列表顺序。 */
-    constraints: string[];
-};
-/** PRD 提取产物。 */
-export type PrdExtraction = {
-    /** PRD 文件绝对路径。 */
-    prdPath: string;
-    /** 解析出的功能条目，按 PRD 顺序排列。 */
-    functions: PrdFunctionEntry[];
-    /** 解析时间 ISO 字符串，仅用于审计，不影响 testcase 生成。 */
-    generatedAt: string;
-};
-/**
- * 在目录中查找 PRD markdown 文件。
- *
- * 规则（满足任一即返回）：
- * 1. 文件名包含 `prd`（大小写不敏感）且以 `.md` 结尾。
- * 2. 文件正文包含 `## 4. 功能需求` 标题。
- *
- * @param dir - 需求文档目录。
- * @returns PRD 文件绝对路径；不存在时返回 undefined。
- */
-export declare function findPrdMarkdown(dir: string): string | undefined;
-/**
- * 读取 PRD 文件并提取功能条目。
- *
- * @param prdPath - PRD markdown 文件绝对路径。
- * @param now - 可选的解析时间戳，用于测试冻结。
- * @returns PRD 提取产物。
- */
-export declare function loadPrdExtraction(prdPath: string, now?: string): PrdExtraction;
-/**
- * 解析 PRD markdown 文本，提取功能列表 + 功能详细说明。
- *
- * @param markdown - PRD 完整 markdown 文本。
- * @returns 按 PRD 顺序排列的功能条目数组。
- */
-export declare function extractPrdFunctions(markdown: string): PrdFunctionEntry[];
-//# sourceMappingURL=prd-extractor.d.ts.map

package/dist/src/extractors/prd-extractor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prd-extractor.d.ts","sourceRoot":"","sources":["../../../src/extractors/prd-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,oBAAoB;AACpB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,aAAa,GAAG;IAC1B,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAsB/D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAA2B,GAAG,aAAa,CAIhG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAqBxE"}

package/dist/src/extractors/prd-extractor.js

@@ -1,248 +0,0 @@
-/**
- * PRD markdown 解析器。
- *
- * 职责：
- * 1. 在需求目录中发现 PRD markdown 文件。
- * 2. 解析 PRD 章节 4.1（功能列表）和 4.2.x（功能详细说明）。
- * 3. 输出结构化的 PrdFunctionEntry[]，供 testcase 装配阶段确定性使用。
- *
- * 设计取舍：
- * - 全程使用正则/行解析，不调用 LLM，保证幂等性。
- * - 只识别当前观察到的 PRD 结构（`4.1` 表格 + `4.2.x` 子章节 + 粗体字段标题）。
- * - 解析失败时返回空数组并在 inferenceTrace 中记录，不阻断 pipeline。
- */
-import { existsSync, readdirSync, readFileSync } from 'node:fs';
-import path from 'node:path';
-/**
- * 在目录中查找 PRD markdown 文件。
- *
- * 规则（满足任一即返回）：
- * 1. 文件名包含 `prd`（大小写不敏感）且以 `.md` 结尾。
- * 2. 文件正文包含 `## 4. 功能需求` 标题。
- *
- * @param dir - 需求文档目录。
- * @returns PRD 文件绝对路径；不存在时返回 undefined。
- */
-export function findPrdMarkdown(dir) {
-    if (!existsSync(dir)) {
-        return undefined;
-    }
-    const candidates = readdirSync(dir).filter((file) => file.endsWith('.md'));
-    for (const file of candidates) {
-        const fullPath = path.join(dir, file);
-        if (/prd/i.test(file)) {
-            return fullPath;
-        }
-    }
-    for (const file of candidates) {
-        const fullPath = path.join(dir, file);
-        const content = readFileSync(fullPath, 'utf8');
-        if (/##\s*4\.\s*功能需求/.test(content)) {
-            return fullPath;
-        }
-    }
-    return undefined;
-}
-/**
- * 读取 PRD 文件并提取功能条目。
- *
- * @param prdPath - PRD markdown 文件绝对路径。
- * @param now - 可选的解析时间戳，用于测试冻结。
- * @returns PRD 提取产物。
- */
-export function loadPrdExtraction(prdPath, now = new Date().toISOString()) {
-    const markdown = readFileSync(prdPath, 'utf8');
-    const functions = extractPrdFunctions(markdown);
-    return { prdPath, functions, generatedAt: now };
-}
-/**
- * 解析 PRD markdown 文本，提取功能列表 + 功能详细说明。
- *
- * @param markdown - PRD 完整 markdown 文本。
- * @returns 按 PRD 顺序排列的功能条目数组。
- */
-export function extractPrdFunctions(markdown) {
-    const functionList = parseFunctionList(markdown);
-    const details = parseFunctionDetails(markdown);
-    const detailMap = new Map(details.map((d) => [d.featureId, d]));
-    // 以功能列表为基准顺序，合并详细说明；若详细说明缺失则使用列表中的描述兜底。
-    return functionList.map((listItem) => {
-        const detail = detailMap.get(listItem.featureId);
-        return {
-            featureId: listItem.featureId,
-            featureName: listItem.featureName,
-            featureModule: listItem.featureModule,
-            description: detail?.description ?? listItem.description,
-            inputConditions: detail?.inputConditions,
-            processingLogic: detail?.processingLogic ?? [],
-            outputResult: detail?.outputResult ?? [],
-            businessRules: detail?.businessRules ?? [],
-            constraints: detail?.constraints ?? [],
-        };
-    });
-}
-/**
- * 解析 4.1 功能列表表格。
- *
- * 表格列（按当前 PRD 约定）：
- * | 功能模块 | 功能编号 | 功能名称 | 功能描述 | 功能类型 | ... |
- */
-function parseFunctionList(markdown) {
-    const result = [];
-    const sectionMatch = markdown.match(/###\s*4\.1\s*功能列表[\s\S]*?(?=###\s*4\.2|##\s+5|\n##\s)/);
-    if (!sectionMatch) {
-        return result;
-    }
-    const lines = sectionMatch[0].split('\n');
-    for (const line of lines) {
-        const trimmed = line.trim();
-        if (!trimmed.startsWith('|'))
-            continue;
-        if (trimmed.includes('功能编号'))
-            continue; // header / separator
-        if (/^\|\s*-+/.test(trimmed))
-            continue; // markdown separator
-        const cells = trimmed
-            .split('|')
-            .map((c) => c.trim())
-            .filter((c) => c.length > 0);
-        if (cells.length < 4)
-            continue;
-        const featureModule = cells[0];
-        const featureId = cells[1];
-        const featureName = cells[2];
-        const description = cells[3];
-        if (!/^F\d{3,}$/i.test(featureId))
-            continue;
-        result.push({ featureId: featureId.toUpperCase(), featureName, featureModule, description });
-    }
-    return result;
-}
-/**
- * 解析 4.2.x 功能详细说明。
- */
-function parseFunctionDetails(markdown) {
-    const result = [];
-    // 匹配每个 4.2.x 子章节：#### 4.2.x Fxxx 功能名称
-    const sectionRegex = /####\s*4\.2\.(\d+)\s+((F\d{3,})\s+(.+?))\s*(?=\n)/g;
-    let match;
-    const sections = [];
-    while ((match = sectionRegex.exec(markdown)) !== null) {
-        sections.push({
-            start: match.index,
-            featureId: match[3].toUpperCase(),
-            featureName: match[4].trim(),
-            end: match.index + match[0].length,
-        });
-    }
-    for (let i = 0; i < sections.length; i++) {
-        const current = sections[i];
-        const nextSection = sections[i + 1];
-        const sectionEnd = findSectionEnd(current.end, markdown, nextSection?.start);
-        const sectionBody = markdown.slice(current.end, sectionEnd);
-        result.push(parseFunctionDetailSection(current.featureId, current.featureName, sectionBody));
-    }
-    return result;
-}
-/**
- * 计算子章节结束位置。
- *
- * 结束位置取以下候选的最小值：
- * 1. 下一个同层 `####` 子章节的开始位置。
- * 2. 下一个更高层标题（`###` 或 `##`）的开始位置。
- * 3. markdown 末尾。
- */
-function findSectionEnd(start, markdown, nextSectionStart) {
-    const nextHeadingMatch = markdown.slice(start).match(/\n#{1,3}\s/m);
-    const nextHeadingStart = nextHeadingMatch
-        ? start + nextHeadingMatch.index + 1 // +1 跳过前面的换行
-        : undefined;
-    const candidates = [nextSectionStart, nextHeadingStart].filter((n) => n !== undefined);
-    return candidates.length > 0 ? Math.min(...candidates) : markdown.length;
-}
-/**
- * 解析单个 4.2.x 子章节内容。
- */
-function parseFunctionDetailSection(featureId, featureName, sectionBody) {
-    const fields = splitDetailFields(sectionBody);
-    return {
-        featureId,
-        featureName,
-        description: fields['功能描述']?.join('\n').trim() ?? '',
-        inputConditions: fields['输入条件']?.join('\n').trim() || undefined,
-        processingLogic: extractListItems(fields['处理逻辑']),
-        outputResult: extractListItems(fields['输出结果']),
-        businessRules: extractListItems(fields['业务规则']),
-        constraints: extractListItems(fields['约束条件']),
-    };
-}
-/**
- * 按粗体字段标题把子章节内容切分成多个字段块。
- *
- * 字段标题形如 `**功能描述**:` 或 `**功能描述**：`（注意中文冒号）。
- */
-function splitDetailFields(body) {
-    const lines = body.split('\n');
-    const fields = {};
-    let currentField;
-    const fieldHeaderRegex = /^\*\*([^*]+)\*\*[:：]\s*(.*)$/;
-    for (const rawLine of lines) {
-        const line = rawLine.trimEnd();
-        const headerMatch = line.trim().match(fieldHeaderRegex);
-        if (headerMatch) {
-            currentField = headerMatch[1].trim();
-            const rest = headerMatch[2].trim();
-            fields[currentField] = [];
-            if (rest) {
-                fields[currentField].push(rest);
-            }
-            continue;
-        }
-        if (currentField && line.trim().length > 0) {
-            // 跳过空行，但保留列表项和缩进内容
-            fields[currentField].push(line);
-        }
-    }
-    return fields;
-}
-/**
- * 从字段块中提取列表项。
- *
- * 支持：
- * - 有序列表 `1. ...`
- * - 无序列表 `- ...`
- * - 缩进列表（二级列表作为前一项的延续，不单独拆分）
- *
- * 过滤：
- * - 空项
- * - 纯 `--` 等表格/排版分隔符
- */
-function extractListItems(lines) {
-    if (!lines || lines.length === 0)
-        return [];
-    const items = [];
-    for (const rawLine of lines) {
-        const line = rawLine.trim();
-        if (line.length === 0)
-            continue;
-        if (/^-+$/.test(line))
-            continue; // 过滤 '--' 分隔符
-        const listMatch = line.match(/^(?:\d+\.|-)\s+(.+)$/);
-        if (listMatch) {
-            const content = listMatch[1].trim();
-            if (content)
-                items.push(content);
-        }
-        else if (line.startsWith('-')) {
-            const content = line.replace(/^-\s*/, '').trim();
-            if (content)
-                items.push(content);
-        }
-        else if (items.length > 0 && rawLine.startsWith('   ')) {
-            // 缩进内容追加到前一项
-            items[items.length - 1] += ' ' + line;
-        }
-        // 非列表行（如普通段落）忽略，避免把标题残留混入
-    }
-    return items;
-}