@accelerator-mzq/forge 1.4.0

package/dist/core/legacy-bridge/mapper.js

@@ -0,0 +1,241 @@
+// 二阶段 mapping 第一阶段:LLM 扫 docs/+src/ → anchors-draft.yaml — Plan 7 Phase D
+// 决策 #4(二阶段 mapping)+ M-2(--merge / --overwrite 语义)
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, relative, extname } from 'node:path';
+import { stringify as stringifyYaml } from 'yaml';
+import { redact } from './redact.js';
+const DEFAULT_DOCS_PATHS = ['docs', 'doc', 'document', 'documents', 'documentation'];
+const SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'forge', // forge 自身产物
+    '.cache',
+]);
+const DEFAULT_MODEL = 'claude-sonnet-4-6';
+const SCAN_FILE_EXTS = new Set(['.md', '.txt', '.csv', '.xlsx']);
+const PREVIEW_LINES = 30;
+/** 递归扫目录 */
+async function* walk(dir, baseRoot) {
+    let entries = [];
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return;
+    }
+    for (const name of entries) {
+        if (SKIP_DIRS.has(name))
+            continue;
+        if (name.startsWith('.') && name !== '.gitattributes')
+            continue;
+        const full = join(dir, name);
+        let s;
+        try {
+            s = await stat(full);
+        }
+        catch {
+            continue;
+        }
+        if (s.isDirectory()) {
+            yield* walk(full, baseRoot);
+        }
+        else if (s.isFile() && SCAN_FILE_EXTS.has(extname(name).toLowerCase())) {
+            yield relative(baseRoot, full);
+        }
+    }
+}
+/** 取文件前 N 行作 preview(LLM 据此推测 role) */
+async function readPreview(path) {
+    const ext = extname(path).toLowerCase();
+    if (ext === '.xlsx') {
+        return '(xlsx 二进制 — 不读取 preview;由 LLM 据文件名推测 role)';
+    }
+    try {
+        const content = await readFile(path, 'utf8');
+        const lines = content.split(/\r?\n/).slice(0, PREVIEW_LINES);
+        return lines.join('\n');
+    }
+    catch {
+        return '(读取失败)';
+    }
+}
+/** 拼 LLM prompt:让 LLM 给一批文件分类 role */
+function buildMapperPrompt(fileEntries) {
+    return `你是一名文档资产分类员。对下面每个文件,判断其属于哪种 brownfield 角色。
+
+# 角色定义
+- requirements:SRS / PRD / 需求规格
+- high-level-design:HLD / 概要设计 / Architecture
+- low-level-design:LLD / 详细设计 / Module Spec
+- system-tests:系统测试用例 / testcases
+- acceptance-report:验收报告
+- rationale:设计决策 / 历史背景
+- glossary:术语表
+- unmatched:不属于上述任何一种(README / changelog / API doc 等)
+
+# 输出格式(必须严格 JSON)
+\`\`\`
+[
+  {"path": "docs/SRS.md", "role": "requirements", "modules": ["payment","order"]}
+]
+\`\`\`
+modules 字段可空(不确定时输出 [])。
+
+# 文件清单
+${fileEntries.map((e) => `## ${e.path}\n${e.preview}`).join('\n\n')}
+
+仅输出 JSON 数组,不输出 preamble。`;
+}
+/** 解析 LLM 返回 */
+function parseMapperResponse(text, fallbackPaths) {
+    try {
+        const arr = JSON.parse(text.trim());
+        if (!Array.isArray(arr))
+            throw new Error('not array');
+        return arr.map((item) => ({
+            path: item.path,
+            role: item.role,
+            modules: item.modules,
+        }));
+    }
+    catch {
+        // 解析失败:全 mark unmatched(用户审)
+        return fallbackPaths.map((p) => ({ path: p, role: 'unmatched' }));
+    }
+}
+/** 跑 mapping(LLM 推测) */
+export async function runMapper(client, input) {
+    const { projectRoot } = input;
+    const docsPaths = input.docsPaths ?? DEFAULT_DOCS_PATHS;
+    // 收集文件
+    const allFiles = [];
+    for (const docDir of docsPaths) {
+        const full = join(projectRoot, docDir);
+        if (!existsSync(full))
+            continue;
+        for await (const f of walk(full, projectRoot)) {
+            allFiles.push(f);
+        }
+    }
+    // 决策 #3a 全自动扫:也扫 src/ 找测试用例(.test / .spec / 测试文件名)
+    if (input.scanSrc) {
+        const srcRoot = join(projectRoot, 'src');
+        if (existsSync(srcRoot)) {
+            for await (const f of walk(srcRoot, projectRoot)) {
+                if (f.includes('test') || f.includes('spec'))
+                    allFiles.push(f);
+            }
+        }
+    }
+    // 读 preview;用 redact mask 敏感数据
+    const entries = [];
+    for (const f of allFiles) {
+        const preview = redact(await readPreview(join(projectRoot, f))).redactedText;
+        entries.push({ path: f, preview });
+    }
+    // 调 LLM
+    let classifications;
+    if (entries.length === 0) {
+        classifications = [];
+    }
+    else {
+        const mapPrompt = buildMapperPrompt(entries);
+        // P7-07 修复:LLM 调用前数据传输声明
+        console.log(`→ sending ${Buffer.byteLength(mapPrompt, 'utf8')} bytes to Anthropic API (provider=anthropic, region: auto, model=${DEFAULT_MODEL}, op=map ${entries.length} files)`);
+        const result = await client.messages.create({
+            model: DEFAULT_MODEL,
+            max_tokens: 4096,
+            messages: [{ role: 'user', content: mapPrompt }],
+        });
+        const block = result.content.find((b) => b.type === 'text');
+        classifications = parseMapperResponse(block?.text ?? '', allFiles);
+    }
+    const newAnchors = [];
+    const unmatched = [];
+    // 同 role 第一个标 authoritative=true(简化策略;用户后审)
+    const roleSeen = new Set();
+    for (const c of classifications) {
+        if (c.role === 'unmatched') {
+            unmatched.push(c.path);
+            continue;
+        }
+        const isFirst = !roleSeen.has(c.role);
+        roleSeen.add(c.role);
+        newAnchors.push({
+            role: c.role,
+            path: c.path,
+            authoritative: isFirst,
+            modules: c.modules,
+        });
+    }
+    // merge 模式:保留 existing 中的 anchor(用户审过部分)
+    let preservedAnchors = [];
+    if (input.mode === 'merge' && input.existing) {
+        const existingPaths = new Set(input.existing.anchors.map((a) => a.path));
+        preservedAnchors = input.existing.anchors;
+        // 新增的 anchor 中,如果 path 已在 existing,跳过(避免重复)
+        const filteredNew = newAnchors.filter((a) => !existingPaths.has(a.path));
+        newAnchors.length = 0;
+        newAnchors.push(...filteredNew);
+    }
+    const finalFile = {
+        schema: 'forge-legacy-anchor/v1',
+        anchors: [...preservedAnchors, ...newAnchors],
+        redact: input.existing?.redact,
+    };
+    const draftYaml = stringifyYaml(finalFile);
+    const draftMarkdown = renderMapperOverview(finalFile, unmatched);
+    return {
+        draftYaml,
+        draftMarkdown,
+        newAnchors,
+        preservedAnchors,
+        unmatched,
+    };
+}
+/** 渲染概览 markdown(给用户审) */
+function renderMapperOverview(file, unmatched) {
+    const lines = [];
+    lines.push('# Legacy Anchors Draft 概览');
+    lines.push('');
+    lines.push('LLM 自动扫描 + 推测的 anchor 草稿。请审改 yaml 后跑 `mv legacy-anchors-draft.yaml legacy-anchors.yaml`。');
+    lines.push('');
+    lines.push('## Anchors by role');
+    const byRole = {};
+    for (const a of file.anchors) {
+        const list = byRole[a.role] ?? [];
+        list.push(a);
+        byRole[a.role] = list;
+    }
+    for (const [role, anchors] of Object.entries(byRole)) {
+        lines.push(`### ${role} (${anchors.length})`);
+        lines.push('');
+        for (const a of anchors) {
+            const auth = a.authoritative ? ' **(authoritative)**' : '';
+            lines.push(`- \`${a.path}\`${auth}${a.modules?.length ? ` modules: ${a.modules.join(', ')}` : ''}`);
+        }
+        lines.push('');
+    }
+    if (unmatched.length > 0) {
+        lines.push('## Unmatched files(LLM 不确定 role)');
+        lines.push('');
+        for (const p of unmatched) {
+            lines.push(`- ${p}`);
+        }
+    }
+    return lines.join('\n');
+}
+/** 写 draft 到磁盘 */
+export async function writeMapperDraft(forgeRoot, output) {
+    const yamlPath = join(forgeRoot, 'legacy-anchors-draft.yaml');
+    const mdPath = join(forgeRoot, 'legacy-anchors-draft.md');
+    const { writeFile, mkdir } = await import('node:fs/promises');
+    await mkdir(forgeRoot, { recursive: true });
+    await writeFile(yamlPath, output.draftYaml, 'utf8');
+    await writeFile(mdPath, output.draftMarkdown, 'utf8');
+    return { yamlPath, mdPath };
+}
+//# sourceMappingURL=mapper.js.map

package/dist/core/legacy-bridge/mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/core/legacy-bridge/mapper.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,oDAAoD;AAGpD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAElD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;AACrF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,cAAc;IACd,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO,EAAE,aAAa;IACtB,QAAQ;CACT,CAAC,CAAC;AAmCH,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAC1C,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACjE,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,YAAY;AACZ,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAW,EAAE,QAAgB;IAChD,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,gBAAgB;YAAE,SAAS;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,CAAC;QACN,IAAI,CAAC;YACH,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACpB,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACzE,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;AACH,CAAC;AAED,uCAAuC;AACvC,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,OAAO,4CAA4C,CAAC;IACtD,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAC7D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,sCAAsC;AACtC,SAAS,iBAAiB,CAAC,WAAqD;IAC9E,OAAO;;;;;;;;;;;;;;;;;;;;;EAqBP,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;;0BAEzC,CAAC;AAC3B,CAAC;AAED,gBAAgB;AAChB,SAAS,mBAAmB,CAC1B,IAAY,EACZ,aAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAIhC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QACtD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACxB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAsC;YACjD,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;QAC7B,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,WAAoB,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,wBAAwB;AACxB,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAoB,EAAE,KAAkB;IACtE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAExD,OAAO;IACP,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,mDAAmD;IACnD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACzC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;gBACjD,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM,OAAO,GAA6C,EAAE,CAAC;IAC7D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ;IACR,IAAI,eAIF,CAAC;IACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,eAAe,GAAG,EAAE,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC7C,yBAAyB;QACzB,OAAO,CAAC,GAAG,CACT,aAAa,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,oEAAoE,aAAa,YAAY,OAAO,CAAC,MAAM,SAAS,CACtK,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC1C,KAAK,EAAE,aAAa;YACpB,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;SACjD,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAqC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAC/F,eAAe,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,UAAU,GAAmB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC3B,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,aAAa,EAAE,OAAO;YACtB,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC;IACL,CAAC;IAED,yCAAyC;IACzC,IAAI,gBAAgB,GAAmB,EAAE,CAAC;IAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,gBAAgB,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC1C,4CAA4C;QAC5C,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,SAAS,GAAsB;QACnC,MAAM,EAAE,wBAAwB;QAChC,OAAO,EAAE,CAAC,GAAG,gBAAgB,EAAE,GAAG,UAAU,CAAC;QAC7C,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM;KAC/B,CAAC;IAEF,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAEjE,OAAO;QACL,SAAS;QACT,aAAa;QACb,UAAU;QACV,gBAAgB;QAChB,SAAS;KACV,CAAC;AACJ,CAAC;AAED,0BAA0B;AAC1B,SAAS,oBAAoB,CAAC,IAAuB,EAAE,SAAmB;IACxE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,0FAA0F,CAC3F,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACb,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxB,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CACR,OAAO,CAAC,CAAC,IAAI,KAAK,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACxF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,kBAAkB;AAClB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAiB,EACjB,MAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,2BAA2B,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;IAC1D,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC9D,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/dist/core/legacy-bridge/quality-judge.d.ts

@@ -0,0 +1,65 @@
+import Anthropic from '@anthropic-ai/sdk';
+import type { KeyFact, QualityResult, LegacyAnchorRole } from './types.js';
+/** 默认总抽样数(决策 #16) */
+export declare const DEFAULT_SAMPLE_TOTAL = 30;
+/** 默认非 critical 保真率阈值(决策 #16) */
+export declare const DEFAULT_FIDELITY_THRESHOLD = 0.9;
+/** 抽样输入 */
+export interface SamplingInput {
+    /** scenario 标注的全部 key facts */
+    allFacts: KeyFact[];
+    /** 总抽样数(默认 DEFAULT_SAMPLE_TOTAL) */
+    total?: number;
+}
+/** 抽样输出 */
+export interface SamplingOutput {
+    /** 实际抽样的 fact 列表(critical 全量在前 + 各章节按比例) */
+    sampled: KeyFact[];
+    /** 各章节抽样数(用于 per_section_rates 计算分母) */
+    perSectionSampled: Record<string, number>;
+    /** 抽样未覆盖的章节(警告) */
+    uncoveredSections: string[];
+}
+/**
+ * 分层抽样(决策 #16):
+ * 1. critical-facts 全量抽(标注的 critical 集合,通常 5-10 条)
+ * 2. 剩余配额按章节比例分配(章节越大抽越多,但每章至少 1 条)
+ * 3. 总抽样数仍约 total,但分布按 1+2 决定
+ *
+ * 防"统计骗术":LLM 集中改写某章导致该章 fact 全丢但其他章 fact 多保留 → per_section_rates 计算时该章为 0
+ */
+export declare function stratifiedSample(input: SamplingInput): SamplingOutput;
+/** judge 三态(decision #16) */
+export type FactState = 'preserved' | 'paraphrased' | 'lost';
+/** judge 单 fact 结果 */
+export interface FactJudgeResult {
+    fact: KeyFact;
+    state: FactState;
+    /** judge 给的简短理由 */
+    reasoning?: string;
+}
+/** judge 客户端的最小接口(便于测试 mock) */
+export interface JudgeClient {
+    messages: {
+        create: (args: Anthropic.Messages.MessageCreateParams) => Promise<Anthropic.Messages.Message>;
+    };
+}
+/**
+ * 用模型 B 验证一条 fact 是否在复写产物里被保留 / 释义 / 丢失。
+ * 输出格式约定:第 1 行三态之一,第 2 行起 reasoning。
+ */
+export declare function judgeSingleFact(client: JudgeClient, regeneratedBody: string, fact: KeyFact): Promise<FactJudgeResult>;
+/** P7-02 修复:LLM 从原文自动抽取 N 条 key fact(spec §3.1 line 337"模型 B 抽 30 条事实")
+ *  用于 regenerate CLI 命令路径(无 scenario YAML 标注时);scenario 上下文请用 stratifiedSample 路径。
+ */
+export declare function extractFactsFromOriginal(client: JudgeClient, originalText: string, n?: number): Promise<KeyFact[]>;
+/** 解析 judge 响应:第 1 行三态,后续 reasoning */
+export declare function parseFactJudgeResponse(text: string, fact: KeyFact): FactJudgeResult;
+/** 跑全部 sampled facts 的判定 + 计算 QualityResult。
+ *  注:Promise.all 不 wrap try/catch — 单条 judgeSingleFact API 失败(网络 / 429)时整个 reject;
+ *  caller(CLI 层)需自行 wrap try/catch 并归类到 .partial 路径。
+ */
+export declare function judgeAllFacts(client: JudgeClient, regeneratedBody: string, sampling: SamplingOutput, threshold?: number): Promise<QualityResult>;
+/** 把 QualityResult 渲染为给用户看的报告 */
+export declare function formatQualityReport(role: LegacyAnchorRole, result: QualityResult): string;
+//# sourceMappingURL=quality-judge.d.ts.map

package/dist/core/legacy-bridge/quality-judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-judge.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/quality-judge.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE3E,qBAAqB;AACrB,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,iCAAiC;AACjC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,WAAW;AACX,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,WAAW;AACX,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,mBAAmB;IACnB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAuFrE;AAUD,6BAA6B;AAC7B,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,CAAC;AAE7D,sBAAsB;AACtB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE;QACR,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,mBAAmB,KAAK,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;KAC/F,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,EACpB,CAAC,GAAE,MAA6B,GAC/B,OAAO,CAAC,OAAO,EAAE,CAAC,CAgDpB;AAED,uCAAuC;AACvC,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,eAAe,CAYnF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,cAAc,EACxB,SAAS,GAAE,MAAmC,GAC7C,OAAO,CAAC,aAAa,CAAC,CAyCxB;AAED,iCAAiC;AACjC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAwCzF"}

package/dist/core/legacy-bridge/quality-judge.js

@@ -0,0 +1,277 @@
+// 双 LLM 抽样保真率验证 — Plan 7 Phase B3
+// 决策 #16 修订(I-2):分层抽样 — critical 全量必抽 + 各章节按比例抽 + 总数约 30
+// 失败路径:critical 任一丢失 → exit 2,无 retry,直接报告 + 写 .partial(spec §5.1)
+/** 默认总抽样数(决策 #16) */
+export const DEFAULT_SAMPLE_TOTAL = 30;
+/** 默认非 critical 保真率阈值(决策 #16) */
+export const DEFAULT_FIDELITY_THRESHOLD = 0.9;
+/**
+ * 分层抽样(决策 #16):
+ * 1. critical-facts 全量抽(标注的 critical 集合,通常 5-10 条)
+ * 2. 剩余配额按章节比例分配(章节越大抽越多,但每章至少 1 条)
+ * 3. 总抽样数仍约 total,但分布按 1+2 决定
+ *
+ * 防"统计骗术":LLM 集中改写某章导致该章 fact 全丢但其他章 fact 多保留 → per_section_rates 计算时该章为 0
+ */
+export function stratifiedSample(input) {
+    const total = input.total ?? DEFAULT_SAMPLE_TOTAL;
+    // 1. critical 全量必抽
+    const critical = input.allFacts.filter((f) => f.critical);
+    const nonCritical = input.allFacts.filter((f) => !f.critical);
+    // 2. 剩余配额给非 critical
+    const remaining = Math.max(0, total - critical.length);
+    if (remaining === 0) {
+        return {
+            sampled: critical,
+            perSectionSampled: countSections(critical),
+            uncoveredSections: [],
+        };
+    }
+    // 按 section 分组
+    const bySection = new Map();
+    for (const f of nonCritical) {
+        const arr = bySection.get(f.section) ?? [];
+        arr.push(f);
+        bySection.set(f.section, arr);
+    }
+    // 每章至少 1 条;剩余按比例(向下取整);最后多余配额从最大章补
+    const totalNonCriticalCount = nonCritical.length;
+    const sampled = [...critical];
+    const perSectionSampled = countSections(critical);
+    if (totalNonCriticalCount === 0) {
+        return { sampled, perSectionSampled, uncoveredSections: [] };
+    }
+    // 各章 quota 计算
+    const sectionEntries = Array.from(bySection.entries()); // [name, facts][]
+    const quotas = new Map();
+    // I-1 修:章节数 > remaining 时,Math.max(1) 强制最少 1 会让 sampled 超 total
+    // canEnforceMinOne=true(章节数 ≤ remaining):每章至少 1 不超 total
+    // canEnforceMinOne=false(章节数 > remaining):放弃"每章至少 1"承诺,按比例分(可能 0)
+    //   后续 I-1 修复 trade-off:大文档章节多但 total 小,会有章节 quota=0 落入 uncoveredSections
+    const canEnforceMinOne = bySection.size <= remaining;
+    for (const [name, facts] of sectionEntries) {
+        const proportionalQuota = Math.floor((facts.length / totalNonCriticalCount) * remaining);
+        quotas.set(name, canEnforceMinOne ? Math.max(1, proportionalQuota) : proportionalQuota);
+    }
+    // 总 quota 校正(向下取整后总和可能 < remaining,从最大章补;最多补到 remaining)
+    // I-2 修:简化为单循环 break,删除 dead modulo 条件(永真,误导)
+    let totalQuota = Array.from(quotas.values()).reduce((a, b) => a + b, 0);
+    if (totalQuota < remaining) {
+        // 按 facts 数从大到小补;每章最多补到 facts.length(不超章节本身能给的 fact 数)
+        const sortedByCount = sectionEntries.slice().sort((a, b) => b[1].length - a[1].length);
+        // 多轮补:每轮按章节大小给每章最多 +1,直到 totalQuota >= remaining 或所有章节已饱和
+        let progressed = true;
+        while (totalQuota < remaining && progressed) {
+            progressed = false;
+            for (const [name, facts] of sortedByCount) {
+                if (totalQuota >= remaining)
+                    break;
+                const cur = quotas.get(name) ?? 0;
+                if (cur < facts.length) {
+                    quotas.set(name, cur + 1);
+                    totalQuota += 1;
+                    progressed = true;
+                }
+            }
+        }
+    }
+    // 各章按 quota 抽样(简单:取前 N 条;实际可随机,但为确定性保留顺序)
+    for (const [name, facts] of sectionEntries) {
+        const q = Math.min(quotas.get(name) ?? 0, facts.length);
+        for (let i = 0; i < q; i += 1) {
+            const f = facts[i];
+            if (f) {
+                sampled.push(f);
+                perSectionSampled[name] = (perSectionSampled[name] ?? 0) + 1;
+            }
+        }
+    }
+    // uncoveredSections:nonCritical 含但 sampled 没的章节
+    const allSections = new Set();
+    for (const f of input.allFacts)
+        allSections.add(f.section);
+    const sampledSections = new Set(sampled.map((f) => f.section));
+    const uncoveredSections = Array.from(allSections).filter((s) => !sampledSections.has(s));
+    return { sampled, perSectionSampled, uncoveredSections };
+}
+function countSections(facts) {
+    const out = {};
+    for (const f of facts) {
+        out[f.section] = (out[f.section] ?? 0) + 1;
+    }
+    return out;
+}
+const JUDGE_MODEL = 'claude-sonnet-4-6';
+/**
+ * 用模型 B 验证一条 fact 是否在复写产物里被保留 / 释义 / 丢失。
+ * 输出格式约定:第 1 行三态之一,第 2 行起 reasoning。
+ */
+export async function judgeSingleFact(client, regeneratedBody, fact) {
+    const prompt = `你是一名复写质量评估员。请判断下面这条"原文事实"是否在"复写产物"里被保留。
+
+# 三态定义
+- preserved:复写产物含字面量或数值完全一致
+- paraphrased:复写产物含同义改写但语义完全等价(含全部数值与约束)
+- lost:复写产物完全没提到 / 漏掉数值 / 漏掉约束
+
+# 原文事实(出自章节 ${fact.section}, ${fact.critical ? 'critical' : 'non-critical'})
+${fact.text}
+
+# 复写产物(只搜本段范围)
+${regeneratedBody}
+
+# 输出格式(必须严格)
+第 1 行:preserved | paraphrased | lost(三选一,小写,不带其他字符)
+第 2 行起:简短理由(1-2 句)`;
+    // P7-07 修复:LLM 调用前数据传输声明(judge 每条 fact 都打一次,可视化进度)
+    console.log(`→ sending ${Buffer.byteLength(prompt, 'utf8')} bytes to Anthropic API (provider=anthropic, region: auto, model=${JUDGE_MODEL}, op=judge fact §${fact.section})`);
+    const result = await client.messages.create({
+        model: JUDGE_MODEL,
+        max_tokens: 256,
+        messages: [{ role: 'user', content: prompt }],
+    });
+    const text = extractText(result);
+    return parseFactJudgeResponse(text, fact);
+}
+/** P7-02 修复:LLM 从原文自动抽取 N 条 key fact(spec §3.1 line 337"模型 B 抽 30 条事实")
+ *  用于 regenerate CLI 命令路径(无 scenario YAML 标注时);scenario 上下文请用 stratifiedSample 路径。
+ */
+export async function extractFactsFromOriginal(client, originalText, n = DEFAULT_SAMPLE_TOTAL) {
+    const prompt = `从下面"原文"中抽出 ${n} 条关键事实(数字 / 字段约束 / 业务规则 / 合规条款 / 设计决策)。
+每条 fact 应是单句、可验证的陈述。输出严格 JSON 数组,每项含 { text, section, critical }。
+- text:简短陈述(<= 80 字)
+- section:原文中所属章节锚(如 "§4.5";若无章节,填 "(unstructured)")
+- critical:布尔,合规 / 安全 / 业务硬约束 = true,其余 = false
+
+# 原文
+${originalText}
+
+仅输出 JSON 数组,不输出 preamble、不带 markdown code fence。`;
+    console.log(`→ sending ${Buffer.byteLength(prompt, 'utf8')} bytes to Anthropic API (provider=anthropic, region: auto, model=${JUDGE_MODEL}, op=extract-facts)`);
+    const result = await client.messages.create({
+        model: JUDGE_MODEL,
+        max_tokens: 4096,
+        messages: [{ role: 'user', content: prompt }],
+    });
+    const text = extractText(result);
+    // I-3 修:LLM 偶尔违反 prompt 输出 ```json ... ``` fence;先剥再 parse
+    // 失败时 console.warn 原始 text 头 200 字,方便用户诊断 LLM 输出问题
+    const cleanText = text
+        .trim()
+        .replace(/^```(?:json|JSON)?\r?\n/, '')
+        .replace(/\r?\n```\s*$/, '')
+        .trim();
+    let parsed;
+    try {
+        parsed = JSON.parse(cleanText);
+    }
+    catch {
+        console.warn(`[quality-judge] LLM extractFacts 输出非合法 JSON;返回空 facts(quality-judge 此 role 跳过)。原文(head 200):\n${text.slice(0, 200)}`);
+        return [];
+    }
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed
+        .map((item) => {
+        const o = item;
+        return {
+            text: typeof o.text === 'string' ? o.text : '',
+            section: typeof o.section === 'string' ? o.section : '(unstructured)',
+            critical: typeof o.critical === 'boolean' ? o.critical : false,
+        };
+    })
+        .filter((f) => f.text.trim().length > 0)
+        .slice(0, n);
+}
+/** 解析 judge 响应:第 1 行三态,后续 reasoning */
+export function parseFactJudgeResponse(text, fact) {
+    const lines = text.trim().split(/\r?\n/);
+    const firstLine = (lines[0] ?? '').trim().toLowerCase();
+    let state;
+    if (firstLine === 'preserved' || firstLine === 'paraphrased' || firstLine === 'lost') {
+        state = firstLine;
+    }
+    else {
+        // 解析失败 → 视为 lost(保守起见,触发用户审 — 决策 #16 不 retry,直接报告)
+        state = 'lost';
+    }
+    const reasoning = lines.slice(1).join('\n').trim() || undefined;
+    return { fact, state, reasoning };
+}
+/** 跑全部 sampled facts 的判定 + 计算 QualityResult。
+ *  注:Promise.all 不 wrap try/catch — 单条 judgeSingleFact API 失败(网络 / 429)时整个 reject;
+ *  caller(CLI 层)需自行 wrap try/catch 并归类到 .partial 路径。
+ */
+export async function judgeAllFacts(client, regeneratedBody, sampling, threshold = DEFAULT_FIDELITY_THRESHOLD) {
+    // TODO(v0.3):Anthropic API rate-limit 防护 — 30 条 fact 全并发可能触发 429
+    // (Tier-1 RPM ~50)。CLI 层加 --concurrency flag,p-limit 包裹。
+    // 当前 v0.2 acceptable:30 并发在 1 秒内瞬时,实际多数路径分散在 judge 时间内。
+    const judged = await Promise.all(sampling.sampled.map((f) => judgeSingleFact(client, regeneratedBody, f)));
+    const critical = judged.filter((r) => r.fact.critical);
+    const nonCritical = judged.filter((r) => !r.fact.critical);
+    const critPreserved = critical.filter((r) => r.state !== 'lost');
+    const totalPreserved = judged.filter((r) => r.state !== 'lost');
+    // critical 必须 100%
+    const criticalRate = critical.length === 0 ? 1.0 : critPreserved.length / critical.length;
+    // 总体保真率
+    const totalRate = judged.length === 0 ? 1.0 : totalPreserved.length / judged.length;
+    // per_section_rates
+    const perSectionRates = {};
+    for (const [section, totalInSection] of Object.entries(sampling.perSectionSampled)) {
+        const sectionJudged = judged.filter((r) => r.fact.section === section);
+        const preserved = sectionJudged.filter((r) => r.state !== 'lost');
+        perSectionRates[section] = totalInSection === 0 ? 1.0 : preserved.length / totalInSection;
+    }
+    const lostCritical = critical.filter((r) => r.state === 'lost').map((r) => r.fact);
+    const lostNonCritical = nonCritical.filter((r) => r.state === 'lost').map((r) => r.fact);
+    const passed = criticalRate >= 1.0 && totalRate >= threshold;
+    return {
+        total_rate: totalRate,
+        critical_rate: criticalRate,
+        per_section_rates: perSectionRates,
+        lost_critical: lostCritical,
+        lost_non_critical: lostNonCritical,
+        uncovered_sections: sampling.uncoveredSections,
+        passed,
+    };
+}
+/** 把 QualityResult 渲染为给用户看的报告 */
+export function formatQualityReport(role, result) {
+    const lines = [];
+    lines.push(`# 复写质量报告(role=${role})`);
+    lines.push('');
+    lines.push(`- 总体保真率:${(result.total_rate * 100).toFixed(1)}%`);
+    lines.push(`- critical 子集保真率:${(result.critical_rate * 100).toFixed(1)}% (须 100%)`);
+    lines.push(`- 抽样未覆盖的章节:${result.uncovered_sections.length === 0 ? '(无)' : result.uncovered_sections.join(', ')}`);
+    lines.push('');
+    if (result.lost_critical.length > 0) {
+        lines.push('## ✗ 丢失的 critical fact(致命,必须用户介入)');
+        for (const f of result.lost_critical) {
+            lines.push(`- (${f.section}) ${f.text}`);
+        }
+        lines.push('');
+    }
+    if (result.lost_non_critical.length > 0) {
+        lines.push('## ⚠ 丢失的 non-critical fact');
+        for (const f of result.lost_non_critical) {
+            lines.push(`- (${f.section}) ${f.text}`);
+        }
+        lines.push('');
+    }
+    lines.push('## 各章节保真率');
+    for (const [section, rate] of Object.entries(result.per_section_rates)) {
+        lines.push(`- ${section}:${(rate * 100).toFixed(1)}%`);
+    }
+    if (!result.passed) {
+        lines.push('');
+        lines.push('## 失败处理(决策 #16,无 retry)');
+        lines.push('- 接受 .partial 产物 + 手动补丢失 fact');
+        lines.push('- 重写 prompt 后重跑 forge legacy-bridge regenerate --role <r>');
+    }
+    return lines.join('\n');
+}
+function extractText(result) {
+    const block = result.content.find((b) => b.type === 'text');
+    return block?.text ?? '';
+}
+//# sourceMappingURL=quality-judge.js.map

package/dist/core/legacy-bridge/quality-judge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-judge.js","sourceRoot":"","sources":["../../../src/core/legacy-bridge/quality-judge.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,yDAAyD;AACzD,mEAAmE;AAKnE,qBAAqB;AACrB,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,iCAAiC;AACjC,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAoB9C;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,oBAAoB,CAAC;IAElD,mBAAmB;IACnB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE9D,qBAAqB;IACrB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,iBAAiB,EAAE,aAAa,CAAC,QAAQ,CAAC;YAC1C,iBAAiB,EAAE,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,eAAe;IACf,MAAM,SAAS,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,mCAAmC;IACnC,MAAM,qBAAqB,GAAG,WAAW,CAAC,MAAM,CAAC;IACjD,MAAM,OAAO,GAAc,CAAC,GAAG,QAAQ,CAAC,CAAC;IACzC,MAAM,iBAAiB,GAA2B,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE1E,IAAI,qBAAqB,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC;IAC/D,CAAC;IAED,cAAc;IACd,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,kBAAkB;IAC1E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,gEAAgE;IAChE,yDAAyD;IACzD,kEAAkE;IAClE,0EAA0E;IAC1E,MAAM,gBAAgB,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC;IACrD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;QAC3C,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,qBAAqB,CAAC,GAAG,SAAS,CAAC,CAAC;QACzF,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC1F,CAAC;IACD,yDAAyD;IACzD,8CAA8C;IAC9C,IAAI,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,IAAI,UAAU,GAAG,SAAS,EAAE,CAAC;QAC3B,uDAAuD;QACvD,MAAM,aAAa,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACvF,0DAA0D;QAC1D,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,OAAO,UAAU,GAAG,SAAS,IAAI,UAAU,EAAE,CAAC;YAC5C,UAAU,GAAG,KAAK,CAAC;YACnB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;gBAC1C,IAAI,UAAU,IAAI,SAAS;oBAAE,MAAM;gBACnC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;oBACvB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;oBAC1B,UAAU,IAAI,CAAC,CAAC;oBAChB,UAAU,GAAG,IAAI,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACnB,IAAI,CAAC,EAAE,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ;QAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzF,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,aAAa,CAAC,KAAgB;IACrC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAaD,MAAM,WAAW,GAAG,mBAAmB,CAAC;AASxC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAmB,EACnB,eAAuB,EACvB,IAAa;IAEb,MAAM,MAAM,GAAG;;;;;;;cAOH,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc;EACxE,IAAI,CAAC,IAAI;;;EAGT,eAAe;;;;mBAIE,CAAC;IAElB,mDAAmD;IACnD,OAAO,CAAC,GAAG,CACT,aAAa,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,oEAAoE,WAAW,oBAAoB,IAAI,CAAC,OAAO,GAAG,CACjK,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC1C,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;KAC9C,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAmB,EACnB,YAAoB,EACpB,IAAY,oBAAoB;IAEhC,MAAM,MAAM,GAAG,cAAc,CAAC;;;;;;;EAO9B,YAAY;;iDAEmC,CAAC;IAChD,OAAO,CAAC,GAAG,CACT,aAAa,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,oEAAoE,WAAW,qBAAqB,CACnJ,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC1C,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;KAC9C,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,2DAA2D;IAC3D,mDAAmD;IACnD,MAAM,SAAS,GAAG,IAAI;SACnB,IAAI,EAAE;SACN,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC;SACtC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,IAAI,EAAE,CAAC;IACV,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CACV,iGAAiG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACtH,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,CAAC,GAAG,IAAwB,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YAC9C,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB;YACrE,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;SAC/D,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SACvC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,IAAa;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxD,IAAI,KAAgB,CAAC;IACrB,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,aAAa,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACrF,KAAK,GAAG,SAAS,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,mDAAmD;QACnD,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IAChE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAmB,EACnB,eAAuB,EACvB,QAAwB,EACxB,YAAoB,0BAA0B;IAE9C,iEAAiE;IACjE,yDAAyD;IACzD,wDAAwD;IACxD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,CACzE,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE3D,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IACjE,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IAEhE,mBAAmB;IACnB,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC1F,QAAQ;IACR,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAEpF,oBAAoB;IACpB,MAAM,eAAe,GAA2B,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACnF,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;QAClE,eAAe,CAAC,OAAO,CAAC,GAAG,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,cAAc,CAAC;IAC5F,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnF,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEzF,MAAM,MAAM,GAAG,YAAY,IAAI,GAAG,IAAI,SAAS,IAAI,SAAS,CAAC;IAE7D,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,aAAa,EAAE,YAAY;QAC3B,iBAAiB,EAAE,eAAe;QAClC,aAAa,EAAE,YAAY;QAC3B,iBAAiB,EAAE,eAAe;QAClC,kBAAkB,EAAE,QAAQ,CAAC,iBAAiB;QAC9C,MAAM;KACP,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,mBAAmB,CAAC,IAAsB,EAAE,MAAqB;IAC/E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,GAAG,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,CACR,cAAc,MAAM,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtG,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,MAAkC;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAqC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAC/F,OAAO,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/core/legacy-bridge/redact.d.ts

@@ -0,0 +1,28 @@
+import type { RedactRule } from './types.js';
+/** 内置默认规则(12+ 类,spec §4.5 完整列表) */
+export declare const DEFAULT_REDACT_RULES: ReadonlyArray<{
+    name: string;
+    regex: string;
+}>;
+/** redact 输出含命中数(用于 --redact-report) */
+export interface RedactReport {
+    /** 每条规则命中次数(name -> count) */
+    hitsByRule: Record<string, number>;
+    /** 总占位数 */
+    totalReplacements: number;
+    /** mask 后的文本 */
+    redactedText: string;
+}
+/**
+ * 对 input 跑 redact,返回 mask 后文本 + 命中数。
+ *
+ * 占位格式:`<<REDACTED-{n}>>`(n 从 1 起递增)。同一规则匹配多处 → n 也递增,
+ * 让 LLM 能区分多处占位但不暴露原值(spec §4.5)。
+ *
+ * @param input  原始文本
+ * @param custom 用户自补规则(legacy-anchors.yaml 的 redact 字段)
+ */
+export declare function redact(input: string, custom?: ReadonlyArray<RedactRule>): RedactReport;
+/** 把 RedactReport 渲染为 stdout 可读形式(--redact-report) */
+export declare function formatRedactReport(report: RedactReport): string;
+//# sourceMappingURL=redact.d.ts.map

package/dist/core/legacy-bridge/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/redact.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,mCAAmC;AACnC,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAkC/E,CAAC;AAEF,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW;IACX,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,aAAa,CAAC,UAAU,CAAM,GAAG,YAAY,CA4D1F;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAc/D"}