@accelerator-mzq/forge 1.4.0 → 3.0.0

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

@@ -0,0 +1,374 @@
+// Layer 3b:whole-repo 发现 + 文本抽取 + prep + apply + 增量 diff(spec §4/§5/§6)
+import { readdir, stat, readFile } from 'node:fs/promises';
+import { join, relative, extname, basename } from 'node:path';
+import { createHash } from 'node:crypto';
+import { stringify as stringifyYaml } from 'yaml';
+import { parseWorkbook, sheetToMarkdown } from './excel.js';
+import { redact } from './redact.js';
+/** 发现时跳过的目录(沿 mapper.ts 的 SKIP_DIRS 约定 + spec §5.1) */
+const SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'dist-bundled',
+    'build',
+    'forge',
+    '.cache',
+]);
+/** 可读取的文档扩展名(spec §5.1 / §5.2) */
+const DOC_EXTS = new Set(['.md', '.txt', '.docx', '.pdf', '.xlsx']);
+/** 需求文档文件名匹配模式(不分大小写) */
+const REQUIREMENT_NAME_RE = /(srs|prd|requirement|需求|规格|spec)/i;
+/** backlog 文件名匹配模式 */
+const BACKLOG_NAME_RE = /^(backlog|todo|roadmap)\b/i;
+/** issue 导出文件名匹配模式 */
+const ISSUE_NAME_RE = /issue/i;
+/** 递归扫目录,产相对 baseRoot 的文件路径 */
+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('.'))
+            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())
+            yield relative(baseRoot, full).split('\\').join('/');
+    }
+}
+/** 据文件名判 kind;不属需求/backlog 任何一类返回 null(不纳入发现) */
+function classifyKind(relPath) {
+    const name = basename(relPath);
+    if (ISSUE_NAME_RE.test(name))
+        return 'issue-export';
+    if (BACKLOG_NAME_RE.test(name))
+        return 'backlog-file';
+    if (REQUIREMENT_NAME_RE.test(name))
+        return 'srs';
+    return null;
+}
+/**
+ * whole-repo 发现(spec §5.1):扫整个仓库,识别需求文档 / backlog 文件。
+ * 排除 SKIP_DIRS;只收 DOC_EXTS 扩展名;按文件名 classifyKind。
+ */
+export async function discoverSources(repoRoot) {
+    const out = [];
+    for await (const rel of walk(repoRoot, repoRoot)) {
+        const ext = extname(rel).toLowerCase();
+        if (!DOC_EXTS.has(ext))
+            continue;
+        const kind = classifyKind(rel);
+        if (kind === null)
+            continue;
+        out.push({ path: rel, kind, ext });
+    }
+    // 排序:跨平台确定,便于测试与 manifest 稳定
+    out.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+    return out;
+}
+/**
+ * 按扩展名抽纯文本(spec §5.2)。
+ * .md/.txt 直读;.xlsx 复用 excel.ts;.docx 用 mammoth;.pdf 用 pdf-parse(v2 class API)。
+ * 读取/解析失败抛带路径的错误。
+ */
+export async function extractText(repoRoot, relPath) {
+    const full = join(repoRoot, relPath);
+    const ext = extname(relPath).toLowerCase();
+    try {
+        if (ext === '.md' || ext === '.txt') {
+            return await readFile(full, 'utf8');
+        }
+        if (ext === '.xlsx') {
+            const wb = await parseWorkbook(full);
+            return wb.sheets.map((s) => sheetToMarkdown(s)).join('\n\n');
+        }
+        if (ext === '.docx') {
+            // mammoth 动态 import:仅 .docx 路径需要,避免无谓加载
+            const mammoth = await import('mammoth');
+            const { value } = await mammoth.extractRawText({ path: full });
+            return value;
+        }
+        if (ext === '.pdf') {
+            // pdf-parse v2:class API(动态 import 仅 .pdf 路径需要,避免无谓加载)
+            const { PDFParse } = await import('pdf-parse');
+            const buf = await readFile(full);
+            const parser = new PDFParse({ data: buf });
+            try {
+                const result = await parser.getText();
+                return result.text;
+            }
+            finally {
+                await parser.destroy();
+            }
+        }
+        throw new Error(`不支持的扩展名 ${ext}`);
+    }
+    catch (err) {
+        throw new Error(`文本抽取失败 ${relPath}:${err.message}`);
+    }
+}
+const DEFAULT_MODEL = 'claude-sonnet-4-6';
+/** 抽取条目数组的 outputSchema 描述(供 agent 自校验,spec §4.2) */
+const EXTRACT_OUTPUT_SCHEMA = '[{ "title": string, "description": string, "status": "implemented"|"unimplemented", ' +
+    '"section": string, "evidence": string[], "confidence": "high"|"medium"|"low" }]';
+/** 单文档抽取 prompt:内嵌 redact 后文本 + redact 后代码索引(spec §4.2) */
+function buildExtractPrompt(args) {
+    return `你是一名需求抽取员。从下面这份老文档抽取需求条目,逐条判定其在当前代码库里是否已实现。
+
+# 文档
+路径:${args.docPath}(kind=${args.docKind})
+---
+${args.redactedText}
+---
+
+# 当前代码库结构索引(file tree;判 implemented 时参考)
+${args.redactedCodeIndex}
+
+# 任务
+- 抽取该文档里的每条需求,给 title(一行)+ description(正文)。
+- 逐条判 status:implemented(代码已实现)或 unimplemented。
+- 判 implemented 必须在 evidence 给出代码依据(形如 "src/foo.ts:42 ...");unimplemented 时 evidence 为 []。
+- section:该条所在章节锚 / 标题;无则空字符串。
+- confidence:你对 status 判定的置信度 high/medium/low。
+
+# 输出格式(严格 JSON,无 preamble)
+${EXTRACT_OUTPUT_SCHEMA}`;
+}
+/**
+ * prep:每来源文档建一个 LlmTask(spec §4.1 第 4 步 / §4.2)。
+ * redact 对**全部输入**(文档文本 + 代码索引);prompt 内嵌 redact 后两者(ApiRunner 只发 prompt)。
+ * @param codeIndex whole-repo 代码文件路径列表(file tree),由调用方传入
+ */
+export async function buildExtractTasks(repoRoot, sources, codeIndex) {
+    // 代码索引对全部 task 相同,redact 一次(spec §4.1 第 3 步:全部输入都 redact,含代码索引)
+    const redactedCodeIndex = redact(codeIndex.join('\n')).redactedText;
+    const tasks = [];
+    for (let i = 0; i < sources.length; i++) {
+        const src = sources[i];
+        const rawText = await extractText(repoRoot, src.path);
+        const redactedText = redact(rawText).redactedText;
+        const prompt = buildExtractPrompt({
+            docPath: src.path,
+            docKind: src.kind,
+            redactedText,
+            redactedCodeIndex,
+        });
+        tasks.push({
+            op: 'extract',
+            // inputs:与 prompt 并列的 redact 快照(文档 + 代码索引;非送 LLM 通道,spec §4.2)
+            inputs: [
+                { source: src.path, content: redactedText },
+                { source: '<code-index>', content: redactedCodeIndex },
+            ],
+            prompt,
+            model: DEFAULT_MODEL,
+            outputSchema: EXTRACT_OUTPUT_SCHEMA,
+            outputPath: `.cache/extract-result-${i}.json`,
+        });
+    }
+    return tasks;
+}
+const STATUS_SET = new Set(['implemented', 'unimplemented']);
+const CONFIDENCE_SET = new Set(['high', 'medium', 'low']);
+/**
+ * 解析 + 校验各 task 结果(spec §4.4 第 2-3 步)。
+ * 每个 ExtractResultInput.text 是需求条目数组的 JSON 字符串。
+ * 非法 JSON / schema 不符 → 抛带 source 的错误。
+ */
+export function parseExtractResults(inputs) {
+    const out = [];
+    for (const input of inputs) {
+        let arr;
+        try {
+            arr = JSON.parse(input.text.trim());
+        }
+        catch (err) {
+            throw new Error(`extract 结果解析失败 ${input.source}:${err.message}`);
+        }
+        if (!Array.isArray(arr)) {
+            throw new Error(`extract 结果 ${input.source}:顶层不是数组`);
+        }
+        arr.forEach((e, i) => {
+            const at = `${input.source}[${i}]`;
+            // 元素守卫:null / 非对象 / 数组提前报错 —— 否则下面 o.title 访问 null 抛无 source 的 TypeError
+            if (e === null || typeof e !== 'object' || Array.isArray(e)) {
+                throw new Error(`${at} 须为 object,实得 ${e === null ? 'null' : typeof e}`);
+            }
+            const o = e;
+            if (typeof o.title !== 'string' || o.title === '')
+                throw new Error(`${at}.title 须为非空字符串`);
+            if (typeof o.description !== 'string')
+                throw new Error(`${at}.description 须为字符串`);
+            if (!STATUS_SET.has(o.status))
+                throw new Error(`${at}.status 越界:${String(o.status)}`);
+            if (!CONFIDENCE_SET.has(o.confidence))
+                throw new Error(`${at}.confidence 越界:${String(o.confidence)}`);
+            if (!Array.isArray(o.evidence) || !o.evidence.every((x) => typeof x === 'string')) {
+                throw new Error(`${at}.evidence 须为 string[]`);
+            }
+            const section = typeof o.section === 'string' ? o.section : '';
+            out.push({
+                title: o.title,
+                description: o.description,
+                status: o.status,
+                source: { document: input.source, section, kind: input.kind },
+                evidence: o.evidence,
+                confidence: o.confidence,
+            });
+        });
+    }
+    return out;
+}
+/** 归一化 content hash:title+description 去空白后 sha256 前 12 位 */
+function contentHash(title, description) {
+    const norm = (title + ' ' + description).replace(/\s+/g, ' ').trim();
+    return createHash('sha256').update(norm, 'utf8').digest('hex').slice(0, 12);
+}
+/** 匹配键(spec §6.1):document +(section 非空用它,否则 content hash) */
+function matchKey(document, section, title, description) {
+    return section !== ''
+        ? `${document} sec:${section}`
+        : `${document} hash:${contentHash(title, description)}`;
+}
+/** ExtractedRequirement → draft LegacyRequirement(id/review 由调用方按 change 定) */
+function toRequirement(e) {
+    return {
+        id: '',
+        title: e.title,
+        description: e.description,
+        status: e.status,
+        source: e.source,
+        evidence: e.evidence,
+        confidence: e.confidence,
+        priority: null,
+        review: 'pending',
+        notes: '',
+    };
+}
+/**
+ * 增量 diff(spec §6.1):本轮抽取条目 vs 已确认 yaml。
+ * 匹配仅在键唯一(旧侧、新侧各恰好 1 条)时进行;任一侧多于 1 条 → conflict。
+ * confirmed 为 null(首次抽取)时全部 new。
+ */
+export function diffAgainstConfirmed(extracted, confirmed) {
+    const oldList = confirmed?.requirements ?? [];
+    // 按键分组
+    const oldByKey = new Map();
+    for (const r of oldList) {
+        const k = matchKey(r.source.document, r.source.section, r.title, r.description);
+        (oldByKey.get(k) ?? oldByKey.set(k, []).get(k)).push(r);
+    }
+    const newByKey = new Map();
+    for (const e of extracted) {
+        const k = matchKey(e.source.document, e.source.section, e.title, e.description);
+        (newByKey.get(k) ?? newByKey.set(k, []).get(k)).push(e);
+    }
+    const draft = [];
+    const allKeys = new Set([...oldByKey.keys(), ...newByKey.keys()]);
+    for (const k of allKeys) {
+        const olds = oldByKey.get(k) ?? [];
+        const news = newByKey.get(k) ?? [];
+        if (olds.length > 1 || news.length > 1) {
+            // 冲突:键非唯一(spec §6.1)。该键下旧 + 新条目一个都不能丢:
+            // 新条目 → conflict,不继承 id
+            for (const e of news)
+                draft.push({ requirement: toRequirement(e), change: 'conflict' });
+            // 旧条目:本轮没抽到该键 → vanished(保留 id,用户决定删不删);
+            //         键被本轮新条目竞争 → 同进 conflict、清空 id(spec §6.1「不继承既有 id」),不静默丢失
+            for (const o of olds) {
+                draft.push(news.length === 0
+                    ? { requirement: o, change: 'vanished' }
+                    : { requirement: { ...o, id: '', review: 'pending' }, change: 'conflict' });
+            }
+            continue;
+        }
+        const old = olds[0];
+        const ne = news[0];
+        if (old && ne) {
+            // matched:复制 id,保留用户 priority/notes;status/evidence/confidence 用新值。
+            // changed 判定须含 title/description/status/evidence/confidence 全部 5 项(spec §6.1
+            //「新值与既有全一致」)—— 漏 evidence/confidence 会把它们的变化误标 unchanged、跳过用户复审。
+            const changed = old.title !== ne.title ||
+                old.description !== ne.description ||
+                old.status !== ne.status ||
+                old.confidence !== ne.confidence ||
+                JSON.stringify(old.evidence) !== JSON.stringify(ne.evidence);
+            draft.push({
+                requirement: {
+                    ...toRequirement(ne),
+                    id: old.id,
+                    priority: old.priority,
+                    notes: old.notes,
+                    review: changed ? 'pending' : 'confirmed',
+                },
+                change: changed ? 'changed' : 'unchanged',
+            });
+        }
+        else if (ne) {
+            draft.push({ requirement: toRequirement(ne), change: 'new' });
+        }
+        else if (old) {
+            draft.push({ requirement: old, change: 'vanished' });
+        }
+    }
+    return draft;
+}
+/** 渲染 draft .md 概览:按 change 分组(spec §6.1 第 3 步) */
+function renderDraftOverview(draft) {
+    const lines = ['# Legacy Requirements Draft 概览', ''];
+    lines.push('LLM 抽取 + 增量 diff 的草稿。请审改 `legacy-requirements-draft.yaml` 后跑 `forge legacy-bridge extract --finalize`。', '');
+    const groups = [
+        ['new', 'New(本轮新抽)'],
+        ['changed', 'Changed(本轮有变更,待复审)'],
+        ['conflict', 'Conflict(匹配键撞,需手动认领 ID / 合并)'],
+        ['vanished', 'Vanished(既有有、本轮没抽到)'],
+        ['unchanged', 'Unchanged(未变,无需复审)'],
+    ];
+    for (const [kind, title] of groups) {
+        const items = draft.filter((d) => d.change === kind);
+        lines.push(`## ${title.split('(')[0].trim()} (${items.length})`, '');
+        if (items.length === 0) {
+            lines.push('(无)', '');
+            continue;
+        }
+        for (const d of items) {
+            const idLabel = d.requirement.id === '' ? '(待分配)' : d.requirement.id;
+            lines.push(`- \`${idLabel}\` ${d.requirement.title} —— ${d.requirement.source.document}` +
+                (d.requirement.source.section ? `#${d.requirement.source.section}` : ''));
+        }
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+/**
+ * --apply 后处理(spec §4.4 第 3-5 步):
+ * 校验汇总 → 增量 diff → 产 draft yaml + md 概览。
+ */
+export function applyExtractResult(results, confirmed) {
+    const extracted = parseExtractResults(results);
+    const draft = diffAgainstConfirmed(extracted, confirmed);
+    const draftFile = {
+        schema: 'forge-legacy-requirements/v1',
+        requirements: draft.map((d) => d.requirement),
+    };
+    return {
+        draftYaml: stringifyYaml(draftFile),
+        draftMarkdown: renderDraftOverview(draft),
+    };
+}
+//# sourceMappingURL=extractor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","sourceRoot":"","sources":["../../../src/core/legacy-bridge/extractor.ts"],"names":[],"mappings":"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"}

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

@@ -1,5 +1,6 @@
 import Anthropic from '@anthropic-ai/sdk';
 import type { LegacyAnchor, LegacyAnchorsFile } from './types.js';
+import type { LlmTask } from './llm-task.js';
 /** 单 anchor 索引项 */
 export interface IndexEntry {
     path: string;
@@ -19,10 +20,15 @@ export interface IndexerClient {
 export declare function chunkText(text: string, maxChunkBytes?: number): string[];
 /** 跑单 anchor 的索引 */
 export declare function indexAnchor(client: IndexerClient, anchor: LegacyAnchor): Promise<IndexEntry>;
-/** 跑全部 authoritative anchor */
-export declare function buildIndex(client: IndexerClient, file: LegacyAnchorsFile): Promise<IndexEntry[]>;
 /** 渲染索引为 markdown(forge/docs/index.md) */
 export declare function renderIndexMarkdown(entries: IndexEntry[]): string;
 /** 摘要长度容差校验(spec §5.4 indexer) */
 export declare function isSummaryWithinTolerance(summary: string): boolean;
+/** 确定性 prep:产 batch 摘要 LlmTask + metadata-only 的 prebuilt 项 */
+export declare function buildIndexTask(file: LegacyAnchorsFile, readText: (anchor: LegacyAnchor) => Promise<string>): Promise<{
+    task: LlmTask | null;
+    prebuilt: IndexEntry[];
+}>;
+/** 确定性后处理:LLM 的 {path:summary} map + prebuilt → index markdown */
+export declare function applyIndexResult(llmText: string, file: LegacyAnchorsFile, prebuilt: IndexEntry[]): string;
 //# sourceMappingURL=indexer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/indexer.ts"],"names":[],"mappings":"AAGA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElE,mBAAmB;AACnB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,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;AAQD,0BAA0B;AAC1B,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,GAAE,MAA8B,GAAG,MAAM,EAAE,CAe/F;AAwBD,oBAAoB;AACpB,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,UAAU,CAAC,CA+BrB;AAED,+BAA+B;AAC/B,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,UAAU,EAAE,CAAC,CAOvB;AAED,0CAA0C;AAC1C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAWjE;AAED,kCAAkC;AAClC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMjE"}
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/indexer.ts"],"names":[],"mappings":"AAGA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,mBAAmB;AACnB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,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;AAQD,0BAA0B;AAC1B,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,GAAE,MAA8B,GAAG,MAAM,EAAE,CAe/F;AAwBD,oBAAoB;AACpB,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,UAAU,CAAC,CA+BrB;AAED,0CAA0C;AAC1C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAWjE;AAED,kCAAkC;AAClC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMjE;AAED,+DAA+D;AAC/D,wBAAsB,cAAc,CAClC,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,GAClD,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CAgC3D;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,UAAU,EAAE,GACrB,MAAM,CAuBR"}

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

@@ -77,15 +77,6 @@ export async function indexAnchor(client, anchor) {
         inputBytes,
     };
 }
-/** 跑全部 authoritative anchor */
-export async function buildIndex(client, file) {
-    const auth = file.anchors.filter((a) => a.authoritative);
-    const out = [];
-    for (const a of auth) {
-        out.push(await indexAnchor(client, a));
-    }
-    return out;
-}
 /** 渲染索引为 markdown(forge/docs/index.md) */
 export function renderIndexMarkdown(entries) {
     const lines = [];
@@ -105,6 +96,67 @@ export function isSummaryWithinTolerance(summary) {
     return (len >= SUMMARY_TARGET_LEN - SUMMARY_TOLERANCE * 2 &&
         len <= SUMMARY_TARGET_LEN + SUMMARY_TOLERANCE * 4);
 }
+/** 确定性 prep:产 batch 摘要 LlmTask + metadata-only 的 prebuilt 项 */
+export async function buildIndexTask(file, readText) {
+    // 只处理 authoritative anchor
+    const auth = file.anchors.filter((a) => a.authoritative);
+    const prebuilt = [];
+    const llmAnchors = [];
+    for (const a of auth) {
+        // metadata-only role 不进 LLM,走 prebuilt 路径
+        if (METADATA_ONLY_INDEX_ROLES.has(a.role)) {
+            prebuilt.push(await indexAnchorMetadataOnly(a));
+            continue;
+        }
+        // 读文件内容并 redact 敏感数据
+        const masked = redact(await readText(a)).redactedText;
+        llmAnchors.push({ anchor: a, masked });
+    }
+    // 所有 anchor 均为 metadata-only,不需要 LLM
+    if (llmAnchors.length === 0)
+        return { task: null, prebuilt };
+    // 构造 batch prompt:合并所有需要 LLM 的 anchor
+    const prompt = `请为下列每份文档产出约 ${SUMMARY_TARGET_LEN} 字摘要。\n严格输出 JSON 对象 {"<path>": "<摘要>"},不加 preamble。\n\n` +
+        llmAnchors.map((x) => `## ${x.anchor.path}(role=${x.anchor.role})\n${x.masked}`).join('\n\n');
+    return {
+        task: {
+            op: 'index',
+            inputs: llmAnchors.map((x) => ({ source: x.anchor.path, content: x.masked })),
+            prompt,
+            model: DEFAULT_MODEL,
+            outputSchema: '{ "<anchor-path>": "<约 100 字摘要>" }',
+            outputPath: '.cache/legacy-bridge-result-index.json',
+        },
+        prebuilt,
+    };
+}
+/** 确定性后处理:LLM 的 {path:summary} map + prebuilt → index markdown */
+export function applyIndexResult(llmText, file, prebuilt) {
+    // 解析 LLM 返回的 {path: summary} JSON 对象
+    let summaries = {};
+    try {
+        const parsed = JSON.parse(llmText.trim());
+        // 排除 JSON 数组:typeof [] === 'object' 亦为 true,放行会产 numeric-key 垃圾条目
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed))
+            summaries = parsed;
+    }
+    catch {
+        // 解析失败:LLM 摘要全空,prebuilt 仍渲染
+    }
+    // 建立 path → role 的反查 map
+    const roleOf = new Map(file.anchors.map((a) => [a.path, a.role]));
+    // 合并 prebuilt 与 LLM 摘要,统一渲染 markdown
+    const entries = [
+        ...prebuilt,
+        ...Object.entries(summaries).map(([path, summary]) => ({
+            path,
+            role: roleOf.get(path) ?? 'unmatched',
+            summary,
+            inputBytes: 0,
+        })),
+    ];
+    return renderIndexMarkdown(entries);
+}
 /** P7-03 修复:metadata-only 索引(不发 LLM,只读文件名 + 可选 frontmatter)
  * spec §7 line 909:验收报告仅在 forge/docs/index.md 索引文件名 + metadata,
  * 不读全文,不发 LLM,提供 trace graph 入口

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

@@ -1 +1 @@
-{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../../../src/core/legacy-bridge/indexer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../../../src/core/legacy-bridge/indexer.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,53 @@
+/** 需求实现状态(spec §3,D1 二值) */
+export type LegacyRequirementStatus = 'implemented' | 'unimplemented';
+/** 审核态(spec §3) */
+export type LegacyRequirementReview = 'pending' | 'confirmed';
+/** 来源类别(spec §3,D3) */
+export type LegacyRequirementKind = 'srs' | 'backlog-file' | 'issue-export';
+/** LLM 判定置信度 */
+export type LegacyRequirementConfidence = 'high' | 'medium' | 'low';
+/** 优先级(用户填) */
+export type LegacyRequirementPriority = 'critical' | 'high' | 'medium' | 'low' | null;
+/** 来源定位 */
+export interface LegacyRequirementSource {
+    /** 来源文件,相对仓库根 */
+    document: string;
+    /** 章节锚 / 标题;无则空字符串 */
+    section: string;
+    kind: LegacyRequirementKind;
+}
+/** 单条 legacy requirement(legacy-requirements.yaml#requirements[]) */
+export interface LegacyRequirement {
+    /** 稳定 ID 'LR-NNNN';draft 里新条目为空字符串 */
+    id: string;
+    title: string;
+    description: string;
+    status: LegacyRequirementStatus;
+    source: LegacyRequirementSource;
+    /** implemented 的代码依据;unimplemented 时为空数组 */
+    evidence: string[];
+    confidence: LegacyRequirementConfidence;
+    priority: LegacyRequirementPriority;
+    review: LegacyRequirementReview;
+    notes: string;
+}
+/** legacy-requirements.yaml 顶层结构 */
+export interface LegacyRequirementsFile {
+    schema: 'forge-legacy-requirements/v1';
+    requirements: LegacyRequirement[];
+}
+/** 文件名常量(确认产物 + draft 态) */
+export declare const LEGACY_REQUIREMENTS_FILE = "legacy-requirements.yaml";
+export declare const LEGACY_REQUIREMENTS_DRAFT_FILE = "legacy-requirements-draft.yaml";
+export declare const LEGACY_REQUIREMENTS_DRAFT_MD = "legacy-requirements-draft.md";
+/** 校验任意对象是否合法 LegacyRequirementsFile;非法即抛错 */
+export declare function validateLegacyRequirementsFile(obj: unknown): LegacyRequirementsFile;
+/** 读 forge/legacy-requirements.yaml;文件不存在返回 null;损坏或非法 schema 抛错 */
+export declare function loadLegacyRequirements(forgeRoot: string): Promise<LegacyRequirementsFile | null>;
+/**
+ * --finalize 纯逻辑(spec §6.2):
+ * 给 id 为空的条目按 max(既有所有 LR-NNNN)+1 顺序分配;整表 review 置 confirmed。
+ * 不读盘/不写盘 —— 调用方(CLI)负责 IO。
+ */
+export declare function finalizeLegacyRequirements(draft: LegacyRequirement[]): LegacyRequirementsFile;
+//# sourceMappingURL=legacy-requirements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-requirements.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/legacy-requirements.ts"],"names":[],"mappings":"AAKA,4BAA4B;AAC5B,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAAG,eAAe,CAAC;AACtE,mBAAmB;AACnB,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,WAAW,CAAC;AAC9D,uBAAuB;AACvB,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,cAAc,GAAG,cAAc,CAAC;AAC5E,gBAAgB;AAChB,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AACpE,eAAe;AACf,MAAM,MAAM,yBAAyB,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC;AAQtF,WAAW;AACX,MAAM,WAAW,uBAAuB;IACtC,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,qBAAqB,CAAC;CAC7B;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,uBAAuB,CAAC;IAChC,MAAM,EAAE,uBAAuB,CAAC;IAChC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,2BAA2B,CAAC;IACxC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,MAAM,EAAE,uBAAuB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,8BAA8B,CAAC;IACvC,YAAY,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED,4BAA4B;AAC5B,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,8BAA8B,mCAAmC,CAAC;AAC/E,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E,8CAA8C;AAC9C,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,CAenF;AAgCD,oEAAoE;AACpE,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAgBxC;AAaD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,sBAAsB,CAW7F"}