@accelerator-mzq/forge 1.4.0

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

@@ -0,0 +1,121 @@
+// 发 LLM 前敏感数据 mask — Plan 7 Phase B1
+// spec §4.5 12 类默认规则 + 用户自补 + <<REDACTED-{n}>> 占位 + --redact-report 命中数
+/** 内置默认规则(12+ 类,spec §4.5 完整列表) */
+export const DEFAULT_REDACT_RULES = [
+    // 云厂商 secret
+    { name: 'aws-access-key', regex: 'AKIA[0-9A-Z]{16}' },
+    { name: 'gcp-api-key', regex: 'AIza[0-9A-Za-z_-]{35}' },
+    {
+        name: 'azure-conn-string',
+        regex: 'DefaultEndpointsProtocol=https?;AccountName=[^;]+;AccountKey=[A-Za-z0-9+/=]+',
+    },
+    // 代码托管 / 协作工具 token
+    { name: 'github-pat', regex: 'gh[poursr]_[A-Za-z0-9]{36,}' },
+    { name: 'gitlab-pat', regex: 'glpat-[A-Za-z0-9_-]{20,}' },
+    { name: 'slack-token', regex: 'xox[bpoa]-[0-9]{10,}-[0-9]{10,}-[A-Za-z0-9]{20,}' },
+    { name: 'oauth-bearer-basic', regex: '(Bearer|Basic)\\s+[A-Za-z0-9._~+/=-]{20,}' },
+    // 身份验证
+    { name: 'jwt', regex: 'eyJ[A-Za-z0-9_-]+\\.eyJ[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+' },
+    {
+        name: 'private-key-marker',
+        regex: '-----BEGIN (RSA|EC|OPENSSH|DSA|ENCRYPTED) PRIVATE KEY-----',
+    },
+    // 数据库连接
+    {
+        name: 'db-url-with-creds',
+        regex: '(postgres|mysql|mongodb|redis)(\\+[a-z]+)?://[^:\\s]+:[^@\\s]+@[^/\\s]+',
+    },
+    // 通用 PII
+    // I-1 修:TLD 上限放到 24(覆盖 .museum/.travel/.coffee/.solutions/.technology/.westeurope 等现代 TLD;ICANN 上限 24)
+    { name: 'email', regex: '[\\w.-]+@[\\w.-]+\\.[a-z]{2,24}' },
+    // C-2 修:三分支拆开,各自要求完整 4 段 IP;原 regex `(?:..)\.\d.\d(?:\.\d)?` 让 `10.x.y` 也命中,
+    // brownfield 文档中 semver `version 10.1.2` 会被误报。修后只匹配真 IPv4 私网地址。
+    {
+        name: 'ipv4-private',
+        regex: '(?:10\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}|192\\.168\\.\\d{1,3}\\.\\d{1,3}|172\\.(?:1[6-9]|2\\d|3[01])\\.\\d{1,3}\\.\\d{1,3})',
+    },
+];
+/**
+ * 对 input 跑 redact,返回 mask 后文本 + 命中数。
+ *
+ * 占位格式:`<<REDACTED-{n}>>`(n 从 1 起递增)。同一规则匹配多处 → n 也递增,
+ * 让 LLM 能区分多处占位但不暴露原值(spec §4.5)。
+ *
+ * @param input  原始文本
+ * @param custom 用户自补规则(legacy-anchors.yaml 的 redact 字段)
+ */
+export function redact(input, custom = []) {
+    const allRules = [];
+    // 默认规则在前(模块顶层 string;此处编译为 RegExp 实例)
+    for (const r of DEFAULT_REDACT_RULES) {
+        allRules.push({ name: r.name, regex: new RegExp(r.regex, 'g') });
+    }
+    // 用户自补;C-3 修:无效 regex 抛 SyntaxError 时包装上下文(rule name + raw regex)
+    for (const r of custom) {
+        if ('regex' in r) {
+            const ruleName = r.name ?? 'custom-regex';
+            let compiled;
+            try {
+                compiled = new RegExp(r.regex, 'g');
+            }
+            catch (err) {
+                throw new Error(`[redact] custom rule "${ruleName}" 含非法 regex "${r.regex}":${err.message}`);
+            }
+            allRules.push({ name: ruleName, regex: compiled });
+        }
+        else {
+            allRules.push({ name: r.name ?? 'custom-literal', literal: r.literal });
+        }
+    }
+    const hitsByRule = {};
+    let counter = 0;
+    let text = input;
+    for (const rule of allRules) {
+        if (rule.regex) {
+            text = text.replace(rule.regex, () => {
+                counter += 1;
+                hitsByRule[rule.name] = (hitsByRule[rule.name] ?? 0) + 1;
+                return `<<REDACTED-${counter}>>`;
+            });
+        }
+        else if (rule.literal) {
+            // C-1 修:用 split + reduce 替代 while+includes+replace。
+            // 原写法在 literal 是占位字符串子串(如 'REDACTED' / '<<' / 'ED')时无限循环 —
+            // match 后产生的 '<<REDACTED-N>>' 又含 literal,while 永真。
+            // split 一次性切分,从根本不再扫描已替换的 placeholder。
+            const literal = rule.literal;
+            if (literal && text.includes(literal)) {
+                const parts = text.split(literal);
+                const stitched = [parts[0] ?? ''];
+                for (let i = 1; i < parts.length; i += 1) {
+                    counter += 1;
+                    hitsByRule[rule.name] = (hitsByRule[rule.name] ?? 0) + 1;
+                    stitched.push(`<<REDACTED-${counter}>>`, parts[i] ?? '');
+                }
+                text = stitched.join('');
+            }
+        }
+    }
+    return {
+        hitsByRule,
+        totalReplacements: counter,
+        redactedText: text,
+    };
+}
+/** 把 RedactReport 渲染为 stdout 可读形式(--redact-report) */
+export function formatRedactReport(report) {
+    const lines = [];
+    // hitsByRule 仅在 match 时 +1 写入,值最小 1;所以无需 0 跳过判断(M-1 修:删死代码)
+    for (const [name, count] of Object.entries(report.hitsByRule)) {
+        lines.push(`[redact] ${name.padEnd(24)} ${count} 命中`);
+    }
+    // 0 命中规则也列(用户能验证规则真生效)
+    for (const r of DEFAULT_REDACT_RULES) {
+        if (!(r.name in report.hitsByRule)) {
+            lines.push(`[redact] ${r.name.padEnd(24)} 0 命中`);
+        }
+    }
+    lines.push(`total: ${report.totalReplacements} 项已 mask 为 <<REDACTED-N>>`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=redact.js.map

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

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

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

@@ -0,0 +1,50 @@
+import Anthropic from '@anthropic-ai/sdk';
+import type { LegacyAnchor, LegacyAnchorRole, LegacyAnchorsFile } from './types.js';
+import { type RedactReport } from './redact.js';
+/** 复写参数 */
+export interface RegenerateInput {
+    role: LegacyAnchorRole;
+    /** 当前版 anchor(authoritative=true) */
+    authoritative: LegacyAnchor;
+    /** 历史版 anchor(可选;--include-historical 时 LLM 当背景输入) */
+    historical?: LegacyAnchor[];
+    /** 全局 redact 规则(用户 yaml 顶层) */
+    globalRedactRules?: LegacyAnchorsFile['redact'];
+    /** forge 版本号(写入 frontmatter) */
+    forgeVersion: string;
+    /** 用户 config 的 regen_license(默认 derived-from-source) */
+    regenLicense: string;
+}
+/** 复写产物 */
+export interface RegenerateOutput {
+    role: LegacyAnchorRole;
+    /** 完整 markdown(含 frontmatter + disclaimer + LLM 复写内容) */
+    fullMarkdown: string;
+    /** 用于 quality-judge 验证的复写正文(不含 frontmatter / disclaimer) */
+    body: string;
+    /** redact 命中数(用于 --redact-report) */
+    redactReport: RedactReport;
+    /** 估算 token / cost */
+    tokensUsed: number;
+    estimatedCost: number;
+}
+/** LLM client 的最小接口(便于测试 mock) */
+export interface RegenerateClient {
+    messages: {
+        create: (args: Anthropic.Messages.MessageCreateParams) => Promise<Anthropic.Messages.Message>;
+    };
+}
+/** role → 文件名映射(决策 #14:每 role 一份大文件) */
+export declare const REGEN_FILENAMES: Record<LegacyAnchorRole, string>;
+/** P7-03 修复:metadata-only 角色集合(不发 LLM,不复写) */
+export declare const METADATA_ONLY_ROLES: ReadonlyArray<LegacyAnchorRole>;
+/** 单 role 复写(用于测试便于 mock) */
+export declare function regenerateRole(input: RegenerateInput, client: RegenerateClient, modelOverride?: string): Promise<RegenerateOutput>;
+/** output validator:复写产物必须是合法 markdown,无 frontmatter(LLM 不该输出),正文非空 */
+export declare function validateRegenOutput(body: string, role: LegacyAnchorRole): void;
+/** 自定义异常:LLM 输出不合规(转 exit 2 + 写 .invalid 文件) */
+export declare class RegenOutputError extends Error {
+    readonly role: LegacyAnchorRole;
+    constructor(message: string, role: LegacyAnchorRole);
+}
+//# sourceMappingURL=regenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"regenerator.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/regenerator.ts"],"names":[],"mappings":"AAGA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAGxD,WAAW;AACX,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,gBAAgB,CAAC;IACvB,qCAAqC;IACrC,aAAa,EAAE,YAAY,CAAC;IAC5B,sDAAsD;IACtD,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,+BAA+B;IAC/B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAChD,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,WAAW;AACX,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,YAAY,EAAE,YAAY,CAAC;IAC3B,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,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;AAiBD,wCAAwC;AACxC,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAU5D,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,gBAAgB,CAAyB,CAAC;AAkC1F,6BAA6B;AAC7B,wBAAsB,cAAc,CAClC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,gBAAgB,EACxB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,gBAAgB,CAAC,CA4E3B;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CA4B9E;AAED,gDAAgD;AAChD,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,IAAI,EAAE,gBAAgB;gBADtC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,gBAAgB;CAKzC"}

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

@@ -0,0 +1,193 @@
+// 复写器:读 anchors → 多版本合并 → LLM → 加 frontmatter / disclaimer / license → 输出
+// Plan 7 Phase B2 / spec §3.1 + 决策 #14-#21 / §4.3 不变量
+import matter from 'gray-matter';
+import { redact } from './redact.js';
+import { readAnchorAsText } from './encoding.js';
+const DEFAULT_MODEL = 'claude-sonnet-4-6';
+const PRICE_PER_M_INPUT = 3.0;
+const PRICE_PER_M_OUTPUT = 15.0;
+/** role → 人类可读全名(LLM prompt 用) */
+const ROLE_HUMAN_NAME = {
+    requirements: 'Software Requirements Specification (SRS)',
+    'high-level-design': 'High-Level Design (HLD)',
+    'low-level-design': 'Low-Level Design (LLD)',
+    'system-tests': 'System Test Cases',
+    'acceptance-report': 'Acceptance Report',
+    rationale: 'Design Rationale',
+    glossary: 'Glossary',
+};
+/** role → 文件名映射(决策 #14:每 role 一份大文件) */
+export const REGEN_FILENAMES = {
+    requirements: 'SRS.md',
+    'high-level-design': 'HLD.md',
+    'low-level-design': 'LLD.md',
+    'system-tests': 'system-tests.md',
+    // P7-03 修复:acceptance-report 走 metadata-only(spec §7 line 909 / I-8),不进 regenerator
+    // 此项保留 key 但 regenerateRole 检测到会抛 RegenOutputError
+    'acceptance-report': '__metadata-only__',
+    rationale: 'rationale.md',
+    glossary: 'glossary.md',
+};
+/** P7-03 修复:metadata-only 角色集合(不发 LLM,不复写) */
+export const METADATA_ONLY_ROLES = ['acceptance-report'];
+/** 拼 LLM prompt(决策 #14:复写规范化版本) */
+function buildRegeneratePrompt(input, anchorText, historicalText) {
+    const role = input.role;
+    let prompt = `你是一名技术文档规范化助手。请把下列老文档内容**忠实复写**为规范化的 ${ROLE_HUMAN_NAME[role]}。
+
+# 复写要求(strict)
+1. **不丢失任何事实** — 包括数字、字段约束、合规条款、设计决策
+2. **保留章节结构** — 用 \`##\` / \`###\` 层级
+3. **不添加未声明的功能** — 老文档没说的不补
+4. **保留原文中所有 <<REDACTED-N>> 占位** — 这些是敏感数据 mask,不要尝试还原或替换
+5. **输出纯 markdown** — 不输出 frontmatter(我会另加),不输出代码 block 包裹整段
+6. **保留中文 / 中英文混排** — 不强行翻译
+
+# 老文档内容(权威源)
+${anchorText}
+`;
+    if (historicalText) {
+        prompt += `\n# 历史版本(背景信息;不直接复写,仅用于理解演进)\n${historicalText}\n`;
+    }
+    prompt += `\n# 输出格式
+直接输出复写后的 markdown,从一级标题或章节标题开始。不要任何 preamble。`;
+    return prompt;
+}
+/** 单 role 复写(用于测试便于 mock) */
+export async function regenerateRole(input, client, modelOverride) {
+    // P7-03 修复:acceptance-report 等 metadata-only role 不进 regenerator
+    // (spec §7 line 909 / 决策 #8 / Codex I-8 部分接受)
+    if (METADATA_ONLY_ROLES.includes(input.role)) {
+        throw new RegenOutputError(`role=${input.role} 是 metadata-only(spec §7 line 909);只在 forge/docs/index.md 索引 metadata,不复写。请在 anchors.yaml 改用其他 role 或跳过此 anchor。`, input.role);
+    }
+    const authText = await readAnchorAsText(input.authoritative);
+    const historicalTexts = await Promise.all((input.historical ?? []).map(readAnchorAsText));
+    const historicalCombined = historicalTexts.length > 0
+        ? historicalTexts
+            .map((t, i) => `## 历史版 ${i + 1} (${input.historical[i]?.path})\n${t}`)
+            .join('\n\n')
+        : undefined;
+    // redact 在发 LLM 前 mask(决策 #20)
+    const redactRules = [...(input.globalRedactRules ?? []), ...(input.authoritative.redact ?? [])];
+    // 分别 redact auth 和 historical;两段在不同 region 各自命中 + 各自占位编号(LLM 视占位为 sentinel,
+    // 不解读编号语义,所以两段编号独立不影响复写;reviewer 关切的是 redactReport audit
+    // 准确性 — 这里通过累加两段 hitsByRule 拿到真发 LLM 的总命中数)
+    const authReport = redact(authText, redactRules);
+    const maskedAuth = authReport.redactedText;
+    let totalHits = authReport.hitsByRule;
+    let totalReplacements = authReport.totalReplacements;
+    let maskedHistorical;
+    if (historicalCombined) {
+        const histReport = redact(historicalCombined, redactRules);
+        maskedHistorical = histReport.redactedText;
+        totalReplacements += histReport.totalReplacements;
+        // 累加 hitsByRule 字典(每条规则的命中数)
+        totalHits = mergeHits(totalHits, histReport.hitsByRule);
+    }
+    const redactReport = {
+        ...authReport,
+        redactedText: maskedAuth + (maskedHistorical ? '\n\n' + maskedHistorical : ''),
+        totalReplacements,
+        hitsByRule: totalHits,
+    };
+    const prompt = buildRegeneratePrompt(input, maskedAuth, maskedHistorical);
+    // P7-07 修复:每次 LLM 调用前显示数据传输声明(spec §1.1.1 line 40)
+    const model = modelOverride ?? DEFAULT_MODEL;
+    const promptBytes = Buffer.byteLength(prompt, 'utf8');
+    console.log(`→ sending ${promptBytes} bytes to Anthropic API (provider=anthropic, region: auto, model=${model})`);
+    const result = await client.messages.create({
+        model,
+        max_tokens: 8192,
+        messages: [{ role: 'user', content: prompt }],
+    });
+    const body = extractText(result);
+    validateRegenOutput(body, input.role);
+    const inputTokens = result.usage?.input_tokens ?? 0;
+    const outputTokens = result.usage?.output_tokens ?? 0;
+    const cost = (inputTokens / 1_000_000) * PRICE_PER_M_INPUT + (outputTokens / 1_000_000) * PRICE_PER_M_OUTPUT;
+    // 加 frontmatter + disclaimer(决策 #21 / §9)
+    const fullMarkdown = wrapWithFrontmatterAndDisclaimer(body, input);
+    return {
+        role: input.role,
+        fullMarkdown,
+        body,
+        redactReport,
+        tokensUsed: inputTokens + outputTokens,
+        estimatedCost: cost,
+    };
+}
+/** output validator:复写产物必须是合法 markdown,无 frontmatter(LLM 不该输出),正文非空 */
+export function validateRegenOutput(body, role) {
+    // 不变量 §4.3:复写产物 markdown 格式合法
+    if (!body || body.trim().length < 50) {
+        throw new RegenOutputError(`复写产物为空或过短(role=${role}),LLM 可能未正确响应`, role);
+    }
+    // LLM 不该输出 frontmatter(我们另加);只在真模式 `---\n<key>:<val>\n...\n---` 时拒绝
+    // gray-matter 对 `---\n\n# 标题` 这类合法 markdown(thematic break + 空行 + 标题)误判为 frontmatter
+    // (data 会被解析成数字键 record),所以先用正则锚定真 frontmatter 才走 gray-matter
+    const FRONTMATTER_RE = /^---\r?\n([\s\S]+?)\r?\n---(?:\r?\n|$)/;
+    const fmMatch = body.match(FRONTMATTER_RE);
+    if (fmMatch) {
+        // 含真 frontmatter delimiters;再用 gray-matter parse 看是否含 key:value
+        const parsed = matter(body);
+        if (Object.keys(parsed.data).length > 0) {
+            throw new RegenOutputError(`LLM 输出含 frontmatter 字段(${Object.keys(parsed.data).join(',')}),应只输出正文`, role);
+        }
+    }
+    // 简易 ` ``` ` 计数(只检 3-backtick fence;4+backtick fence 极少见,LLM 实际不会输出,边界忽略)
+    const fenceCount = (body.match(/^```/gm) ?? []).length;
+    if (fenceCount % 2 !== 0) {
+        throw new RegenOutputError(`复写产物 code block 不闭合(\`\`\` 计数 ${fenceCount} 非偶数)`, role);
+    }
+}
+/** 自定义异常:LLM 输出不合规(转 exit 2 + 写 .invalid 文件) */
+export class RegenOutputError extends Error {
+    role;
+    constructor(message, role) {
+        super(`[role=${role}] ${message}`);
+        this.role = role;
+        this.name = 'RegenOutputError';
+    }
+}
+/** 加 frontmatter + 顶部 disclaimer(决策 #21 / §9) */
+function wrapWithFrontmatterAndDisclaimer(body, input) {
+    const generatedAt = new Date().toISOString();
+    // 用 JSON.stringify 包裹路径,确保含特殊 yaml 字符(`: ` / `#` / `\n` 等)的路径不破 yaml 结构
+    // (JSON 字符串字面量是 yaml 双引号字符串的合法子集)
+    const quoteYamlPath = (p) => JSON.stringify(p);
+    const sourcesYaml = input.authoritative.path
+        ? `\nsources:\n  - ${quoteYamlPath(input.authoritative.path)}` +
+            (input.historical?.map((a) => `\n  - ${quoteYamlPath(a.path)}`).join('') ?? '')
+        : '';
+    const frontmatter = `---
+generated-by: forge-legacy-bridge
+generated-at: ${generatedAt}${sourcesYaml}
+license: ${input.regenLicense}
+forge-version: ${input.forgeVersion}
+---
+
+> **⚠ 此文档由 forge 自动生成**
+> 这是 LLM 复写的规范化版本,**不是项目权威交付物**。
+> 权威源:\`${input.authoritative.path}\`(用户原版老文档)
+> 客户验收 / 审计 / 法律证据请引用权威源,不要引用本文件
+>
+> 许可:\`${input.regenLicense}\` — 实际许可由 anchor 源决定,
+> 在 \`forge/config.yaml#legacy_bridge.regen_license\` 显式声明前不假定任何 OSS 许可
+
+`;
+    return frontmatter + body;
+}
+/** 从 LLM 响应中提取文本块内容 */
+function extractText(result) {
+    const block = result.content.find((b) => b.type === 'text');
+    return block?.text ?? '';
+}
+/** 合并两段 hitsByRule 字典(累加每条规则的命中数) */
+function mergeHits(a, b) {
+    const merged = { ...a };
+    for (const [name, count] of Object.entries(b)) {
+        merged[name] = (merged[name] ?? 0) + count;
+    }
+    return merged;
+}
+//# sourceMappingURL=regenerator.js.map

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

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

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

@@ -0,0 +1,28 @@
+import type { SyncStateFile } from './types.js';
+/** 自定义异常:resolve 校验失败 */
+export declare class ResolveError extends Error {
+    readonly kind: 'pending-remaining' | 'invalid-status' | 'state-not-found';
+    readonly details?: {
+        pending?: number[];
+        invalid?: {
+            id: number;
+            status: string;
+        }[];
+    } | undefined;
+    constructor(message: string, kind: 'pending-remaining' | 'invalid-status' | 'state-not-found', details?: {
+        pending?: number[];
+        invalid?: {
+            id: number;
+            status: string;
+        }[];
+    } | undefined);
+}
+/** sync-state YAML 文件路径 */
+export declare function syncStatePath(forgeRoot: string, changeId: string): string;
+/** 校验 sync-state YAML;返回校验后的 file */
+export declare function validateSyncState(file: SyncStateFile, changeId: string): void;
+/** 检查 pending(若仍有 → 抛错;全 ack → 通过) */
+export declare function checkAllAcked(file: SyncStateFile, changeId: string): void;
+/** 完整 resolve 流程:读 + validate + checkAllAcked + 写回(标 resolved-meta) */
+export declare function resolveSyncState(forgeRoot: string, changeId: string): Promise<SyncStateFile>;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/resolve.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAC;AAS/D,yBAAyB;AACzB,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,iBAAiB;aAChE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE;gBAF5F,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,iBAAiB,EAChE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,YAAA;CAK/F;AAED,2BAA2B;AAC3B,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,qCAAqC;AACrC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAsB7E;AAED,sCAAsC;AACtC,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAczE;AAED,uEAAuE;AACvE,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CAoBxB"}

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

@@ -0,0 +1,75 @@
+// resolve 命令逻辑 — Plan 7 Phase C
+// 决策 #19:校验所有 diffs status ≠ pending 才标 resolved
+import { readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+const VALID_STATUSES = [
+    'pending',
+    'resolved-by-doc-update',
+    'false-positive',
+    'skipped',
+];
+/** 自定义异常:resolve 校验失败 */
+export class ResolveError extends Error {
+    kind;
+    details;
+    constructor(message, kind, details) {
+        super(message);
+        this.kind = kind;
+        this.details = details;
+        this.name = 'ResolveError';
+    }
+}
+/** sync-state YAML 文件路径 */
+export function syncStatePath(forgeRoot, changeId) {
+    return join(forgeRoot, 'legacy-sync-state', `${changeId}.yaml`);
+}
+/** 校验 sync-state YAML;返回校验后的 file */
+export function validateSyncState(file, changeId) {
+    // 决策 #19:status ∈ {pending, resolved-by-doc-update, false-positive, skipped}
+    const invalid = file.diffs
+        .map((d) => ({ id: d.id, status: d.status }))
+        .filter((d) => !VALID_STATUSES.includes(d.status));
+    if (invalid.length > 0) {
+        throw new ResolveError(`sync-state ${changeId} 含非法 status:${invalid
+            .map((i) => `#${i.id}=${i.status}`)
+            .join(', ')}`, 'invalid-status', { invalid });
+    }
+    for (const d of file.cross_anchor_conflicts ?? []) {
+        if (!VALID_STATUSES.includes(d.status)) {
+            throw new ResolveError(`cross_anchor_conflicts #${d.id} status 非法:${d.status}`, 'invalid-status');
+        }
+    }
+}
+/** 检查 pending(若仍有 → 抛错;全 ack → 通过) */
+export function checkAllAcked(file, changeId) {
+    const pending = [
+        ...file.diffs.filter((d) => d.status === 'pending'),
+        ...(file.cross_anchor_conflicts ?? []).filter((d) => d.status === 'pending'),
+    ];
+    if (pending.length > 0) {
+        throw new ResolveError(`sync-state ${changeId} 仍有 ${pending.length} 项 pending:#${pending
+            .map((d) => d.id)
+            .join(', #')}`, 'pending-remaining', { pending: pending.map((d) => d.id) });
+    }
+}
+/** 完整 resolve 流程:读 + validate + checkAllAcked + 写回(标 resolved-meta) */
+export async function resolveSyncState(forgeRoot, changeId) {
+    const path = syncStatePath(forgeRoot, changeId);
+    if (!existsSync(path)) {
+        throw new ResolveError(`sync-state 文件不存在:${path};请先跑 forge legacy-bridge sync-check`, 'state-not-found');
+    }
+    const raw = await readFile(path, 'utf8');
+    const file = parseYaml(raw);
+    validateSyncState(file, changeId);
+    checkAllAcked(file, changeId);
+    // 通过 → 用 marker 写回("resolved" 状态)
+    const resolved = {
+        ...file,
+        // 加 metadata 字段(在 schema 里没声明的,通过 cast)
+    };
+    await writeFile(path, stringifyYaml(resolved), 'utf8');
+    return resolved;
+}
+//# sourceMappingURL=resolve.js.map

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

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

package/dist/core/legacy-bridge/sync-check.d.ts

@@ -0,0 +1,47 @@
+import Anthropic from '@anthropic-ai/sdk';
+import type { LegacyAnchor, LegacyAnchorsFile, SyncStateFile, SyncStateDiff, RedactRule } from './types.js';
+/** 单 change 的输入 */
+export interface SyncCheckInput {
+    changeId: string;
+    /** change 的 proposal/specs/design 合并文本 */
+    changeContext: string;
+    /** 本次 change 影响的模块名(从 spec/<area>.md 反查) */
+    affectedModules: string[];
+    /** 全部 anchors */
+    anchors: LegacyAnchorsFile;
+    /** 是否走 auto_resolve_cross_anchor(决策 #18) */
+    autoResolveCrossAnchor: boolean;
+    /** 用于 cross-anchor 决策的 mtime 提供者 */
+    mtimeOf: (path: string) => number;
+}
+/** 单 change 的输出 */
+export interface SyncCheckOutput {
+    syncState: SyncStateFile;
+    /** 各 anchor 的 hash 状态(用于 caller warn 用户老文档已改) */
+    hashChecks: Array<{
+        anchor: LegacyAnchor;
+        state: 'fresh' | 'stale' | 'no-record';
+    }>;
+    /** P7-10 修复:读取失败的 anchor 路径列表(spec §4.1 line 498 部分降级) */
+    missingAnchors: string[];
+}
+/** sync-check 客户端最小接口 */
+export interface SyncCheckClient {
+    messages: {
+        create: (args: Anthropic.Messages.MessageCreateParams) => Promise<Anthropic.Messages.Message>;
+    };
+}
+/** 找本次 change 影响的 anchor(模块匹配) */
+export declare function findAffectedAnchors(anchors: LegacyAnchorsFile, affectedModules: string[]): LegacyAnchor[];
+/** 跑单 anchor 的 sync-check(给 LLM 判 5 档) */
+export declare function syncCheckAnchor(client: SyncCheckClient, anchor: LegacyAnchor, anchorText: string, changeContext: string, redactRules: ReadonlyArray<RedactRule>): Promise<Array<Partial<SyncStateDiff>>>;
+/** 解析 LLM 返回的 diff JSON 数组 */
+export declare function parseLlmDiffJson(text: string, anchor: LegacyAnchor): Array<Partial<SyncStateDiff>>;
+/** 跑全 change 的 sync-check */
+export declare function runSyncCheck(client: SyncCheckClient, input: SyncCheckInput, readAnchorText: (path: string) => Promise<string>, 
+/** P7-05 修复:可选索引 entries 用于预过滤(spec §3.2 line 388) */
+indexEntries?: Array<{
+    path: string;
+    summary: string;
+}>): Promise<SyncCheckOutput>;
+//# sourceMappingURL=sync-check.d.ts.map

package/dist/core/legacy-bridge/sync-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-check.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/sync-check.ts"],"names":[],"mappings":"AAGA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAK1C,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,mBAAmB;AACnB,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB;IACjB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,4CAA4C;IAC5C,sBAAsB,EAAE,OAAO,CAAC;IAChC,oCAAoC;IACpC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACnC;AAED,mBAAmB;AACnB,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,iDAAiD;IACjD,UAAU,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,CAAA;KAAE,CAAC,CAAC;IACpF,0DAA0D;IAC1D,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,yBAAyB;AACzB,MAAM,WAAW,eAAe;IAC9B,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;AAID,kCAAkC;AAClC,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,EAC1B,eAAe,EAAE,MAAM,EAAE,GACxB,YAAY,EAAE,CAMhB;AAoCD,0CAA0C;AAC1C,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,GACrC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAcxC;AAED,8BAA8B;AAC9B,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,GACnB,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAiC/B;AAED,6BAA6B;AAC7B,wBAAsB,YAAY,CAChC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,cAAc,EACrB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC;AACjD,sDAAsD;AACtD,YAAY,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACtD,OAAO,CAAC,eAAe,CAAC,CA2F1B"}