spectra-cli 4.1.1

package/dist/panoramic/pipelines/adr-decision-pipeline.js

@@ -0,0 +1,421 @@
+/**
+ * ADR 决策流水线
+ *
+ * 基于项目级结构化输出、模块 spec、current-spec、增量 spec 与 git 提交历史，
+ * 生成候选 ADR 草稿与索引。该流水线优先使用确定性证据匹配，避免把 ADR 草稿
+ * 变成“看起来合理”的纯 LLM 幻觉文本。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { loadTemplate } from '../utils/template-loader.js';
+export function generateBatchAdrDocs(options) {
+    const corpus = buildAdrCorpus(options);
+    const warnings = new Set();
+    const candidates = buildAdrCandidates(corpus);
+    if (candidates.length === 0) {
+        warnings.add('未识别到足够稳定的 ADR 候选信号，已仅生成空索引。');
+    }
+    const drafts = candidates
+        .sort((left, right) => right.score - left.score || left.title.localeCompare(right.title))
+        .slice(0, 4)
+        .map((candidate, index) => finalizeDraft(index + 1, candidate));
+    const adrDir = path.join(options.outputDir, 'docs', 'adr');
+    const writtenFiles = [];
+    for (const draft of drafts) {
+        const markdown = renderAdrDraft(draft);
+        const baseName = `${draft.decisionId.toLowerCase()}-${draft.slug}`;
+        const mdPath = path.join(adrDir, `${baseName}.md`);
+        fs.mkdirSync(adrDir, { recursive: true });
+        fs.writeFileSync(mdPath, markdown, 'utf-8');
+        writtenFiles.push(mdPath);
+    }
+    const index = {
+        title: `ADR 决策索引: ${corpus.projectName}`,
+        generatedAt: new Date().toISOString(),
+        projectName: corpus.projectName,
+        summary: buildIndexSummary(corpus, drafts),
+        draftCount: drafts.length,
+        warnings: [...warnings],
+        drafts,
+    };
+    fs.mkdirSync(adrDir, { recursive: true });
+    const indexMarkdown = renderAdrIndex(index);
+    const indexMarkdownPath = path.join(adrDir, 'index.md');
+    fs.writeFileSync(indexMarkdownPath, indexMarkdown, 'utf-8');
+    writtenFiles.push(indexMarkdownPath);
+    return {
+        index,
+        drafts,
+        warnings: [...warnings],
+        writtenFiles,
+    };
+}
+function renderAdrDraft(draft) {
+    const template = loadTemplate('adr-draft.hbs', import.meta.url);
+    return template(draft);
+}
+function renderAdrIndex(output) {
+    const template = loadTemplate('adr-index.hbs', import.meta.url);
+    return template(output);
+}
+function buildAdrCorpus(options) {
+    const entries = [];
+    const projectName = options.architectureNarrative.projectName;
+    entries.push({
+        sourceType: 'architecture-narrative',
+        label: 'executive-summary',
+        path: path.join(options.outputDir, 'architecture-narrative.md'),
+        text: [
+            ...options.architectureNarrative.executiveSummary,
+            ...options.architectureNarrative.observations,
+        ].join('\n'),
+    });
+    for (const module of options.architectureNarrative.keyModules) {
+        entries.push({
+            sourceType: 'architecture-narrative',
+            label: `module:${module.sourceTarget}`,
+            path: path.join(options.outputDir, 'architecture-narrative.md'),
+            text: [
+                module.sourceTarget,
+                module.displayName,
+                module.intentSummary,
+                module.businessSummary,
+                module.dependencySummary,
+                ...module.keySymbols.map((symbol) => `${symbol.kind}:${symbol.name}:${symbol.note}`),
+                ...module.keyMethods.map((method) => `${method.kind}:${method.name}:${method.note}`),
+            ].join('\n'),
+        });
+    }
+    if (options.patternHints) {
+        entries.push({
+            sourceType: 'pattern-hints',
+            label: 'pattern-summary',
+            path: path.join(options.outputDir, 'pattern-hints.md'),
+            text: options.patternHints.model.matchedPatterns
+                .map((hint) => [
+                hint.patternName,
+                hint.summary,
+                hint.explanation,
+                ...hint.matchedSignals,
+            ].join('\n'))
+                .join('\n\n'),
+        });
+    }
+    if (options.architectureOverview) {
+        entries.push({
+            sourceType: 'architecture-overview',
+            label: 'overview-summary',
+            path: path.join(options.outputDir, 'architecture-overview.md'),
+            text: [
+                options.architectureOverview.title,
+                summarizeArchitectureSection(options.architectureOverview.systemContext),
+                summarizeArchitectureSection(options.architectureOverview.deploymentView),
+                summarizeArchitectureSection(options.architectureOverview.layeredView),
+            ].filter(Boolean).join('\n'),
+        });
+    }
+    for (const filePath of collectMarkdownEvidenceFiles(options.projectRoot)) {
+        const normalized = normalizeProjectPath(filePath, options.projectRoot);
+        const lower = normalized.toLowerCase();
+        let sourceType = 'spec';
+        if (lower.endsWith('/current-spec.md')) {
+            sourceType = 'current-spec';
+        }
+        else if (lower.endsWith('/blueprint.md')) {
+            sourceType = 'blueprint';
+        }
+        entries.push({
+            sourceType,
+            label: normalized,
+            path: normalized,
+            text: readTrimmed(filePath, 24_000),
+        });
+    }
+    for (const sourcePath of collectSourcePathSignals(options.projectRoot)) {
+        entries.push({
+            sourceType: 'source-path',
+            label: sourcePath,
+            path: sourcePath,
+            text: sourcePath,
+        });
+    }
+    const commits = loadRecentGitCommits(options.projectRoot);
+    for (const commit of commits) {
+        entries.push({
+            sourceType: 'commit',
+            label: commit.sha.slice(0, 7),
+            text: [commit.subject, commit.body].filter(Boolean).join('\n'),
+        });
+    }
+    return {
+        projectName,
+        projectRoot: options.projectRoot,
+        architectureNarrative: options.architectureNarrative,
+        architectureOverview: options.architectureOverview,
+        patternHints: options.patternHints,
+        commits,
+        entries,
+    };
+}
+// Feature 140 T37 (FR-003) — buildAdrCandidates 内部 8 个 hardcoded candidate 函数已删除：
+// - buildCliHostedRuntimeCandidate / buildStreamJsonProtocolCandidate
+// - buildRegistryExtensibilityCandidate / buildDeterministicFactsCandidate
+// - buildCurrentSpecFactSourceCandidate / buildAppendOnlySessionCandidate
+// - buildContainerizedRuntimeCandidate / buildModularSeparationCandidate
+// 还有 buildGenericCoreSeparationCandidate fallback 也已删除。
+//
+// 这 8 个函数原本基于关键词匹配（matchEvidence）触发候选，导致任何足够大的项目都会
+// 偶然命中关键词，产出 Spectra 自身架构的模板套壳 ADR（hallucination），这是 spec
+// FR-003 锁定要求清除的"ADR 质量问题 1 — ADR hallucinate"根因。
+//
+// 替代实现：`runAdrMapReduce`（src/panoramic/pipelines/adr-mapreduce.ts）通过
+// cluster orchestrator + Map (sonnet) / Reduce (opus) + evidence 真实性校验
+// 产出项目特有的 ADR。本同步入口保留作为兼容 stub：返回空数组让既有 caller
+// 不至于崩溃，但 ADR 实际产出依赖调用方传入 anthropicClient 并切换到 MapReduce 路径。
+function buildAdrCandidates(_corpus) {
+    // 同步路径不再产出 ADR（MapReduce 路径是 async，由 caller 显式选择）
+    return [];
+}
+function finalizeDraft(index, candidate) {
+    const decisionId = `ADR-${String(index).padStart(4, '0')}`;
+    const slug = slugify(candidate.title);
+    const sourceTypes = uniqueSorted(candidate.evidence.map((item) => item.sourceType));
+    return {
+        decisionId,
+        slug,
+        title: candidate.title,
+        status: 'proposed',
+        category: candidate.category,
+        confidence: candidate.confidence,
+        inferred: candidate.inferred,
+        sourceTypes,
+        summary: candidate.summary,
+        decision: candidate.decision,
+        context: candidate.context,
+        consequences: candidate.consequences,
+        alternatives: candidate.alternatives,
+        evidence: candidate.evidence,
+    };
+}
+function buildIndexSummary(corpus, drafts) {
+    const lines = [
+        `本批次基于 ${drafts.length} 个候选 ADR 草稿组织决策索引，输入事实主要来自架构叙事、模式提示、现有 spec/current-spec 与近期提交历史。`,
+    ];
+    if (corpus.patternHints?.model.matchedPatterns.length) {
+        lines.push(`模式提示中识别到 ${corpus.patternHints.model.matchedPatterns.length} 条可用模式证据，可作为 ADR 背景的结构化补充。`);
+    }
+    if (corpus.commits.length > 0) {
+        lines.push(`已纳入最近 ${Math.min(corpus.commits.length, 20)} 条 git 提交标题作为演进证据。`);
+    }
+    else {
+        lines.push('未检测到可读取的 git 提交历史，部分 ADR 仅基于当前代码与文档结构推断。');
+    }
+    return lines;
+}
+function evidenceFromModule(module) {
+    const excerpt = [module.intentSummary, module.businessSummary, module.dependencySummary]
+        .filter(Boolean)
+        .join(' ')
+        .trim();
+    if (!excerpt) {
+        return null;
+    }
+    return {
+        sourceType: 'architecture-narrative',
+        label: module.sourceTarget,
+        path: 'architecture-narrative.md',
+        excerpt,
+    };
+}
+function summarizeArchitectureSection(section) {
+    if (!section) {
+        return '';
+    }
+    const parts = [
+        section.title,
+        section.description ?? '',
+        ...section.nodes.slice(0, 4).map((node) => `${node.kind}:${node.label}`),
+        ...section.edges.slice(0, 4).map((edge) => `${edge.from}->${edge.to}:${edge.relation}`),
+        section.missingReason ?? '',
+    ].filter(Boolean);
+    return parts.join(' | ');
+}
+function summarizeEvidenceText(text, loweredKeywords) {
+    const normalized = text.replace(/\r/g, '');
+    const lines = normalized.split('\n').map((line) => line.trim()).filter(Boolean);
+    const matchedLine = lines.find((line) => {
+        const lowered = line.toLowerCase();
+        return loweredKeywords.some((keyword) => lowered.includes(keyword));
+    });
+    const source = matchedLine ?? lines[0] ?? normalized;
+    return source.length > 240 ? `${source.slice(0, 237)}...` : source;
+}
+function collectMarkdownEvidenceFiles(projectRoot) {
+    const specsDir = path.join(projectRoot, 'specs');
+    if (!fs.existsSync(specsDir)) {
+        return [];
+    }
+    const results = [];
+    walkDirectory(specsDir, (filePath) => {
+        const relative = normalizeProjectPath(filePath, projectRoot).toLowerCase();
+        if (relative.endsWith('/current-spec.md')
+            || relative.endsWith('/blueprint.md')
+            || relative.endsWith('/spec.md')) {
+            results.push(filePath);
+        }
+    });
+    return results.sort((left, right) => left.localeCompare(right));
+}
+function collectSourcePathSignals(projectRoot) {
+    const results = [];
+    walkDirectory(projectRoot, (filePath) => {
+        const relative = normalizeProjectPath(filePath, projectRoot);
+        const lower = relative.toLowerCase();
+        if (lower.startsWith('.git/')
+            || lower.startsWith('node_modules/')
+            || lower.startsWith('dist/')
+            || lower.startsWith('coverage/')
+            || lower.startsWith('specs/')
+            || lower.startsWith('.spectra')) {
+            return;
+        }
+        results.push(relative);
+    });
+    return results.sort((left, right) => left.localeCompare(right));
+}
+function walkDirectory(dir, onFile) {
+    if (!fs.existsSync(dir)) {
+        return;
+    }
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isSymbolicLink()) {
+            continue;
+        }
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walkDirectory(fullPath, onFile);
+            continue;
+        }
+        if (entry.isFile()) {
+            onFile(fullPath);
+        }
+    }
+}
+function loadRecentGitCommits(projectRoot) {
+    const result = spawnSync('git', ['-C', projectRoot, 'log', '--no-color', '--pretty=format:%H%x1f%s%x1f%b%x1e', '-n', '20'], { encoding: 'utf-8' });
+    if (result.status !== 0 || !result.stdout) {
+        return [];
+    }
+    return result.stdout
+        .split('\x1e')
+        .map((chunk) => chunk.trim())
+        .filter(Boolean)
+        .map((chunk) => {
+        const [sha, subject, body] = chunk.split('\x1f');
+        return {
+            sha: sha ?? '',
+            subject: subject ?? '',
+            body: body ?? '',
+        };
+    })
+        .filter((entry) => entry.sha && entry.subject);
+}
+function normalizeProjectPath(filePath, projectRoot) {
+    const relative = path.relative(projectRoot, filePath);
+    return relative.split(path.sep).join('/');
+}
+function readTrimmed(filePath, maxLength) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const normalized = content.replace(/\r/g, '');
+    return normalized.length > maxLength ? normalized.slice(0, maxLength) : normalized;
+}
+function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9\u4e00-\u9fa5]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 80);
+}
+function uniqueSorted(items) {
+    return [...new Set(items)].sort((left, right) => left.localeCompare(right));
+}
+// ============================================================
+// DocumentGenerator Adapter
+// ============================================================
+/**
+ * AdrDecisionPipelineGenerator
+ *
+ * 将 generateBatchAdrDocs() 适配为 DocumentGenerator 接口。
+ * generate() 包含 fs 文件写出副作用（写出 ADR 草稿与索引）。
+ * render() 为纯 Markdown 摘要，不含 fs 调用。
+ *
+ * TInput: GenerateBatchAdrDocsOptions
+ * TOutput: GenerateBatchAdrDocsResult
+ */
+export class AdrDecisionPipelineGenerator {
+    id = 'adr-decision-pipeline';
+    name = 'ADR 决策流水线生成器';
+    description = '基于架构事实与模块 spec 生成候选 ADR 草稿与索引，并写出到 outputDir/docs/adr/';
+    outputDir;
+    constructor(outputDir) {
+        this.outputDir = outputDir;
+    }
+    isApplicable(context) {
+        // 只要项目根目录存在即可适用（outputDir 由构造函数注入）
+        return Boolean(context.projectRoot);
+    }
+    async extract(context) {
+        // 构造最小化 options，必需字段来自 context 和 outputDir
+        // architectureNarrative 必须提供，此处使用最小 stub（由编排层注入完整值）
+        return {
+            projectRoot: context.projectRoot,
+            outputDir: this.outputDir,
+            projectContext: context,
+            generatedDocs: [],
+            architectureNarrative: {
+                title: '',
+                generatedAt: new Date().toISOString().split('T')[0],
+                projectName: '',
+                executiveSummary: [],
+                repositoryMap: [],
+                keyModules: [],
+                keySymbols: [],
+                keyMethods: [],
+                observations: [],
+                supportingDocs: [],
+            },
+        };
+    }
+    async generate(input, _options) {
+        // generate() 包含 fs 写出副作用（写出 ADR 文件）
+        return generateBatchAdrDocs(input);
+    }
+    render(output) {
+        // render() 为纯摘要，无 fs 调用
+        const { index } = output;
+        const lines = [
+            `# ${index.title}`,
+            '',
+            `**生成时间**: ${index.generatedAt}`,
+            `**ADR 草稿数**: ${index.draftCount}`,
+            '',
+            ...index.summary,
+        ];
+        if (output.writtenFiles.length > 0) {
+            lines.push('', '**写出文件**:');
+            for (const file of output.writtenFiles) {
+                lines.push(`- ${file}`);
+            }
+        }
+        if (output.warnings.length > 0) {
+            lines.push('', '**警告**:');
+            for (const warning of output.warnings) {
+                lines.push(`- ${warning}`);
+            }
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=adr-decision-pipeline.js.map

package/dist/panoramic/pipelines/adr-decision-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-decision-pipeline.js","sourceRoot":"","sources":["../../../src/panoramic/pipelines/adr-decision-pipeline.ts"],"names":[],"mappings":"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"}

package/dist/panoramic/pipelines/adr-evidence-verifier.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Feature 140 ADR evidenceRef 输入格式（来自 LLM Map 阶段输出）。
+ *
+ * 与既有 `AdrEvidenceRef` 不同：本结构是 LLM 必须填充的"代码 evidence"格式，
+ * 强制要求 source（文件路径）+ location（行号范围）+ snippet（原文片段）三件套。
+ */
+export interface EvidenceRefInput {
+    /** 文件路径（相对 projectRoot 或绝对路径）*/
+    source: string;
+    /** 行号范围（"L42-58" 格式，包含两端；单行可写 "L42" 或 "L42-42"）*/
+    location: string;
+    /** 文件实际内容片段（用于校验 snippet 匹配） */
+    snippet: string;
+}
+/** 校验后的 evidenceRef，追加 verified + verificationReason 字段 */
+export interface VerifiedEvidenceRef extends EvidenceRefInput {
+    /** 是否通过 file/line/snippet 三重验证 */
+    verified: boolean;
+    /** 校验失败原因（仅 verified=false 时填充）*/
+    verificationReason?: 'file-not-found' | 'invalid-location-format' | 'line-out-of-range' | 'snippet-mismatch' | 'read-failed';
+}
+/**
+ * 校验一组 evidenceRef 的真实性。
+ *
+ * @param refs LLM 输出的 evidenceRef 列表
+ * @param projectRoot 项目根目录（绝对路径），用于解析相对 source
+ * @returns 每条 ref 追加 verified + 失败原因；不抛错（无效 ref 标 verified=false 但保留在结果中）
+ */
+export declare function verifyEvidenceRefs(refs: EvidenceRefInput[], projectRoot: string): VerifiedEvidenceRef[];
+//# sourceMappingURL=adr-evidence-verifier.d.ts.map

package/dist/panoramic/pipelines/adr-evidence-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-evidence-verifier.d.ts","sourceRoot":"","sources":["../../../src/panoramic/pipelines/adr-evidence-verifier.ts"],"names":[],"mappings":"AAqBA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2DAA2D;AAC3D,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,kBAAkB,CAAC,EACf,gBAAgB,GAChB,yBAAyB,GACzB,mBAAmB,GACnB,kBAAkB,GAClB,aAAa,CAAC;CACnB;AAgBD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,gBAAgB,EAAE,EACxB,WAAW,EAAE,MAAM,GAClB,mBAAmB,EAAE,CAEvB"}

package/dist/panoramic/pipelines/adr-evidence-verifier.js

@@ -0,0 +1,141 @@
+/**
+ * ADR Evidence Verifier (Feature 140 T40)
+ *
+ * 实现 spec FR-005 — ADR evidenceRef 自动真实性校验。
+ *
+ * 防止 LLM 在 ADR 草稿中编造不存在的代码引用。每条 evidenceRef 程序化校验：
+ *  (1) source 文件存在（fs.existsSync）
+ *  (2) location 行号范围有效（解析 "L42-58" 格式，检查文件实际行数）
+ *  (3) snippet 与文件实际内容字符匹配（允许 ≤10% 空白差异：normalize whitespace 后
+ *      Levenshtein 距离 / snippet.length ≤ 0.1）
+ *
+ * Validation gate：有效 evidenceRefs（verified=true）< 2 条的 ADR 应从产物中移除
+ * （由 caller 实施；本模块只负责打 verified 标记）。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// ============================================================
+// 常量
+// ============================================================
+/** spec FR-005 锁定：snippet 允许的空白差异比例上限（10%）*/
+const SNIPPET_WHITESPACE_DIFF_TOLERANCE = 0.1;
+/** location 格式正则：匹配 "L42" 或 "L42-58"（允许大写 L 或小写 l）*/
+const LOCATION_REGEX = /^[Ll](\d+)(?:-(\d+))?$/;
+// ============================================================
+// 核心校验函数
+// ============================================================
+/**
+ * 校验一组 evidenceRef 的真实性。
+ *
+ * @param refs LLM 输出的 evidenceRef 列表
+ * @param projectRoot 项目根目录（绝对路径），用于解析相对 source
+ * @returns 每条 ref 追加 verified + 失败原因；不抛错（无效 ref 标 verified=false 但保留在结果中）
+ */
+export function verifyEvidenceRefs(refs, projectRoot) {
+    return refs.map((ref) => verifyOne(ref, projectRoot));
+}
+function verifyOne(ref, projectRoot) {
+    // 解析文件绝对路径
+    const absPath = path.isAbsolute(ref.source)
+        ? ref.source
+        : path.join(projectRoot, ref.source);
+    // 修复 Codex W-2: path traversal 防护 — evidence 必须在 projectRoot 内
+    // 防止 LLM 用 `../../../etc/passwd` 这类相对路径拿到任意文件作 fake evidence
+    const normalizedAbs = path.resolve(absPath);
+    const normalizedRoot = path.resolve(projectRoot);
+    if (!normalizedAbs.startsWith(normalizedRoot + path.sep) && normalizedAbs !== normalizedRoot) {
+        return { ...ref, verified: false, verificationReason: 'file-not-found' };
+    }
+    // (1) 文件存在性
+    if (!fs.existsSync(absPath)) {
+        return { ...ref, verified: false, verificationReason: 'file-not-found' };
+    }
+    // (2) 解析 location 格式
+    const locationMatch = LOCATION_REGEX.exec(ref.location);
+    if (!locationMatch) {
+        return { ...ref, verified: false, verificationReason: 'invalid-location-format' };
+    }
+    const startLine = parseInt(locationMatch[1], 10);
+    const endLine = locationMatch[2] !== undefined ? parseInt(locationMatch[2], 10) : startLine;
+    // 行号必须 ≥ 1 且 startLine ≤ endLine
+    if (startLine < 1 || endLine < startLine) {
+        return { ...ref, verified: false, verificationReason: 'invalid-location-format' };
+    }
+    // (3) 读取文件内容并校验行号范围 + snippet
+    let fileContent;
+    try {
+        fileContent = fs.readFileSync(absPath, 'utf-8');
+    }
+    catch {
+        return { ...ref, verified: false, verificationReason: 'read-failed' };
+    }
+    const lines = fileContent.split('\n');
+    // 行号越界（注：文件最后一行可能没有 trailing newline，lines.length 可能 = endLine 或 endLine+1）
+    if (endLine > lines.length) {
+        return { ...ref, verified: false, verificationReason: 'line-out-of-range' };
+    }
+    // 提取 location 指定行的实际内容（1-based, 含两端）
+    const actualSnippet = lines.slice(startLine - 1, endLine).join('\n');
+    // (4) snippet 匹配（≤10% 空白差异）
+    if (!snippetMatches(ref.snippet, actualSnippet)) {
+        return { ...ref, verified: false, verificationReason: 'snippet-mismatch' };
+    }
+    return { ...ref, verified: true };
+}
+// ============================================================
+// snippet 匹配算法
+// ============================================================
+/**
+ * 比较两个 snippet 是否"实质相等"，允许 ≤10% 空白差异。
+ *
+ * 算法：
+ *  1. Normalize 双方：折叠所有连续空白（含换行）为单个空格、首尾 trim
+ *  2. 计算 Levenshtein 距离（normalize 后）
+ *  3. 距离 / max(len1, len2) ≤ 0.1 → 视为匹配
+ *
+ * 这种宽容匹配兼容 LLM 输出中的空白格式漂移（缩进 / 换行风格 / trailing space）。
+ */
+function snippetMatches(llmSnippet, fileSnippet) {
+    const a = normalizeWhitespace(llmSnippet);
+    const b = normalizeWhitespace(fileSnippet);
+    if (a === b)
+        return true;
+    if (a.length === 0 || b.length === 0)
+        return false;
+    const distance = levenshtein(a, b);
+    const ratio = distance / Math.max(a.length, b.length);
+    return ratio <= SNIPPET_WHITESPACE_DIFF_TOLERANCE;
+}
+function normalizeWhitespace(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Levenshtein 距离（编辑距离）— 标准 DP 实现。
+ * 复杂度 O(m*n)。snippet 通常 < 200 字符，性能可接受。
+ */
+function levenshtein(a, b) {
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    // 滚动数组优化：只需保留 prev 行（O(min(m, n)) 空间）
+    const m = a.length;
+    const n = b.length;
+    // 选短的一边作内层循环，长的作外层（减少内层数组大小）
+    const [shorter, longer] = m <= n ? [a, b] : [b, a];
+    const sm = shorter.length;
+    const ln = longer.length;
+    let prev = Array.from({ length: sm + 1 }, (_, i) => i);
+    for (let i = 1; i <= ln; i++) {
+        const curr = [i];
+        for (let j = 1; j <= sm; j++) {
+            const cost = longer[i - 1] === shorter[j - 1] ? 0 : 1;
+            curr.push(Math.min(prev[j] + 1, // 删除
+            curr[j - 1] + 1, // 插入
+            prev[j - 1] + cost));
+        }
+        prev = curr;
+    }
+    return prev[sm];
+}
+//# sourceMappingURL=adr-evidence-verifier.js.map

package/dist/panoramic/pipelines/adr-evidence-verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-evidence-verifier.js","sourceRoot":"","sources":["../../../src/panoramic/pipelines/adr-evidence-verifier.ts"],"names":[],"mappings":"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"}