@accelerator-mzq/forge 1.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../../src/core/legacy-bridge/anchors.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,yCAAyC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,iEAAiE;AACjE,MAAM,WAAW,GAAG;IAClB,cAAc;IACd,mBAAmB;IACnB,kBAAkB;IAClB,cAAc;IACd,mBAAmB;IACnB,WAAW;IACX,UAAU;CACoC,CAAC;AAEjD,wDAAwD;AACxD,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGzB;IAFlB,YACE,OAAe,EACC,IAAa;QAE7B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAF9B,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB;IACrD,MAAM,IAAI,GAAG,GAAG,SAAS,sBAAsB,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,0EAA0E;IAC1E,qEAAqE;IACrE,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,kBAAkB,CAAC,QAAS,GAA6B,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,mCAAmC;QACnC,MAAM,IAAI,kBAAkB,CAAC,aAAc,GAAa,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,mBAAmB,CAAC,IAAa,EAAE,GAAW;IAC5D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,IAAI,GAAG,IAAkC,CAAC;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,wBAAwB,EAAE,CAAC;QAC7C,MAAM,IAAI,kBAAkB,CAC1B,4CAA4C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EACjE,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,cAAc;IACd,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,cAAc,CAAC,CAAC,EAAE,GAAG,GAAG,YAAY,GAAG,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,kDAAkD;IAClD,MAAM,UAAU,GAAG,IAAI,GAAG,EAA4B,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;YACpB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QACjD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,IAAI,kBAAkB,CAC1B,SAAS,IAAI,OAAO,KAAK,8CAA8C,EACvE,GAAG,CACJ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAyB,CAAC;AACnC,CAAC;AAED,0CAA0C;AAC1C,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAErE,SAAS,cAAc,CAAC,CAAU,EAAE,GAAW;IAC7C,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,EAAE,GAAG,CAA0B,CAAC;IACtC,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAwB,CAAC,EAAE,CAAC;QACtF,MAAM,IAAI,kBAAkB,CAC1B,SAAS,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC/D,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,2BAA2B;IAC3B,IAAI,oCAAoC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,kBAAkB,CAC1B,SAAS,EAAE,CAAC,IAAI,mDAAmD,EACnE,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,qDAAqD;IACrD,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,kBAAkB,CAC1B,SAAS,EAAE,CAAC,IAAI,cAAc,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,uCAAuC,EACjG,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,EAAE,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,uBAAuB,CAAC,IAAuB;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;AACrD,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,MAAM,CAAC,GAAG,IAAI,GAAG,EAAoC,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -0,0 +1,39 @@
+/** 默认警告阈值(spec §4.4:regenerate > $20 警告) */
+export declare const REGEN_WARN_USD = 20;
+export declare const SYNC_CHECK_WARN_USD = 5;
+/** 估算 regenerate 全 4 role 全 anchor 总 cost */
+export declare function estimateRegenerateCost(anchorCount: number): number;
+/** 估算 sync-check 一次跑(单 change)cost */
+export declare function estimateSyncCheckCost(affectedAnchorCount: number): number;
+/** 估算 index 一次跑(全 anchor)cost */
+export declare function estimateIndexCost(anchorCount: number): number;
+/** 估算 map 一次跑 cost(LLM 扫 docs+src) */
+export declare function estimateMapCost(): number;
+/** TTY/非 TTY 分支:超阈值时根据环境处理 */
+export interface BudgetGateResult {
+    /** 是否继续 */
+    proceed: boolean;
+    /** 给 caller 显示的提示文本 */
+    message: string;
+    /** 退出码(proceed=false 时,>0) */
+    exitCode: number;
+    /**
+     * I-1 修:caller 是否需要在 print message 后调 `await countdown()`。
+     * 仅 TTY 超阈值路径为 true;其余三路径 false。
+     * 避免 caller 用 `message.includes('5 秒后继续')` 字符串耦合。
+     */
+    requiresCountdown: boolean;
+}
+/**
+ * 阈值闸门:
+ * - 估算 < threshold → 继续(proceed=true)
+ * - 估算 ≥ threshold + TTY → 5 秒倒计时(由 caller 用 setTimeout 实现);返回 proceed=true
+ * - 估算 ≥ threshold + 非 TTY + yesFlag=true → 继续
+ * - 估算 ≥ threshold + 非 TTY + yesFlag=false → proceed=false,exit 1 + 提示 --yes
+ *
+ * Note:实际倒计时不在本函数(避免 IO),由 caller 在 message 后做 setTimeout。
+ */
+export declare function checkBudgetGate(estimated: number, threshold: number, yesFlag?: boolean, ttyOverride?: boolean): BudgetGateResult;
+/** 5 秒倒计时(给 caller 用) */
+export declare function countdown(seconds?: number): Promise<void>;
+//# sourceMappingURL=budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/budget.ts"],"names":[],"mappings":"AAYA,4CAA4C;AAC5C,eAAO,MAAM,cAAc,KAAO,CAAC;AACnC,eAAO,MAAM,mBAAmB,IAAM,CAAC;AAEvC,6CAA6C;AAC7C,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED,sCAAsC;AACtC,wBAAgB,qBAAqB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,iCAAiC;AACjC,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,sCAAsC;AACtC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,8BAA8B;AAC9B,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,EACxB,WAAW,CAAC,EAAE,OAAO,GACpB,gBAAgB,CAqClB;AAED,yBAAyB;AACzB,wBAAsB,SAAS,CAAC,OAAO,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlE"}

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

@@ -0,0 +1,83 @@
+// brownfield 命令 cost 估算 + TTY 倒计时 / 非 TTY --yes 强制 — Plan 7 Phase B1
+// spec §4.4:regenerate > $20 时 TTY 5 秒倒计时;非 TTY 拒绝运行 + 提示 --yes flag
+import { isatty } from 'node:tty';
+/** 估算单次 brownfield LLM 调用平均 cost(USD;单 anchor 复写约 5k input + 3k output token) */
+const APPROX_COST_PER_REGEN_PER_ANCHOR_USD = 0.075;
+const APPROX_COST_PER_SYNC_CHECK_PER_ANCHOR_USD = 0.012;
+const APPROX_COST_PER_INDEX_PER_ANCHOR_USD = 0.005;
+const APPROX_COST_PER_MAP_TOTAL_USD = 0.6;
+const APPROX_COST_QUALITY_JUDGE_PER_ROLE_USD = 0.06;
+/** 默认警告阈值(spec §4.4:regenerate > $20 警告) */
+export const REGEN_WARN_USD = 20.0;
+export const SYNC_CHECK_WARN_USD = 5.0;
+/** 估算 regenerate 全 4 role 全 anchor 总 cost */
+export function estimateRegenerateCost(anchorCount) {
+    return (anchorCount * APPROX_COST_PER_REGEN_PER_ANCHOR_USD + 4 * APPROX_COST_QUALITY_JUDGE_PER_ROLE_USD // 4 role 各跑一次 quality-judge
+    );
+}
+/** 估算 sync-check 一次跑(单 change)cost */
+export function estimateSyncCheckCost(affectedAnchorCount) {
+    return affectedAnchorCount * APPROX_COST_PER_SYNC_CHECK_PER_ANCHOR_USD;
+}
+/** 估算 index 一次跑(全 anchor)cost */
+export function estimateIndexCost(anchorCount) {
+    return anchorCount * APPROX_COST_PER_INDEX_PER_ANCHOR_USD;
+}
+/** 估算 map 一次跑 cost(LLM 扫 docs+src) */
+export function estimateMapCost() {
+    return APPROX_COST_PER_MAP_TOTAL_USD;
+}
+/**
+ * 阈值闸门:
+ * - 估算 < threshold → 继续(proceed=true)
+ * - 估算 ≥ threshold + TTY → 5 秒倒计时(由 caller 用 setTimeout 实现);返回 proceed=true
+ * - 估算 ≥ threshold + 非 TTY + yesFlag=true → 继续
+ * - 估算 ≥ threshold + 非 TTY + yesFlag=false → proceed=false,exit 1 + 提示 --yes
+ *
+ * Note:实际倒计时不在本函数(避免 IO),由 caller 在 message 后做 setTimeout。
+ */
+export function checkBudgetGate(estimated, threshold, yesFlag = false, ttyOverride) {
+    const tty = ttyOverride ?? isatty(1);
+    // M-1 修:`<=` 与 spec §4.4 ">$20 触发警告" 一致 — 浮点估算极少精确等于阈值,
+    // 但精确边界归 "未超" 路径更符合 spec 措辞,且测试更可预期。
+    if (estimated <= threshold) {
+        return {
+            proceed: true,
+            message: `估算 cost ≈ $${estimated.toFixed(2)}(<= 阈值 $${threshold.toFixed(2)})`,
+            exitCode: 0,
+            requiresCountdown: false,
+        };
+    }
+    // 估算超阈值
+    if (tty) {
+        return {
+            proceed: true,
+            message: `⚠ 估算 cost ≈ $${estimated.toFixed(2)},超阈值 $${threshold.toFixed(2)};5 秒后继续,Ctrl-C 取消`,
+            exitCode: 0,
+            requiresCountdown: true,
+        };
+    }
+    if (yesFlag) {
+        return {
+            proceed: true,
+            message: `⚠ 估算 cost ≈ $${estimated.toFixed(2)};非 TTY + --yes,继续`,
+            exitCode: 0,
+            requiresCountdown: false,
+        };
+    }
+    return {
+        proceed: false,
+        message: `✗ 估算 cost ≈ $${estimated.toFixed(2)},超阈值 $${threshold.toFixed(2)};\n非 TTY 环境(CI / 脚本管道)需加 --yes flag 显式同意`,
+        exitCode: 1,
+        requiresCountdown: false,
+    };
+}
+/** 5 秒倒计时(给 caller 用) */
+export async function countdown(seconds = 5) {
+    for (let i = seconds; i > 0; i -= 1) {
+        process.stderr.write(`\r${i}...`);
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+    }
+    process.stderr.write('\n');
+}
+//# sourceMappingURL=budget.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../../src/core/legacy-bridge/budget.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qEAAqE;AAErE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,iFAAiF;AACjF,MAAM,oCAAoC,GAAG,KAAK,CAAC;AACnD,MAAM,yCAAyC,GAAG,KAAK,CAAC;AACxD,MAAM,oCAAoC,GAAG,KAAK,CAAC;AACnD,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAC1C,MAAM,sCAAsC,GAAG,IAAI,CAAC;AAEpD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,6CAA6C;AAC7C,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO,CACL,WAAW,GAAG,oCAAoC,GAAG,CAAC,GAAG,sCAAsC,CAAC,4BAA4B;KAC7H,CAAC;AACJ,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,qBAAqB,CAAC,mBAA2B;IAC/D,OAAO,mBAAmB,GAAG,yCAAyC,CAAC;AACzE,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,WAAW,GAAG,oCAAoC,CAAC;AAC5D,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,eAAe;IAC7B,OAAO,6BAA6B,CAAC;AACvC,CAAC;AAkBD;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,SAAiB,EACjB,UAAmB,KAAK,EACxB,WAAqB;IAErB,MAAM,GAAG,GAAG,WAAW,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;IAErC,wDAAwD;IACxD,qCAAqC;IACrC,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,cAAc,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;YAC7E,QAAQ,EAAE,CAAC;YACX,iBAAiB,EAAE,KAAK;SACzB,CAAC;IACJ,CAAC;IAED,QAAQ;IACR,IAAI,GAAG,EAAE,CAAC;QACR,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,gBAAgB,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB;YAC7F,QAAQ,EAAE,CAAC;YACX,iBAAiB,EAAE,IAAI;SACxB,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,gBAAgB,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB;YAChE,QAAQ,EAAE,CAAC;YACX,iBAAiB,EAAE,KAAK;SACzB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,gBAAgB,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,0CAA0C;QACpH,QAAQ,EAAE,CAAC;QACX,iBAAiB,EAAE,KAAK;KACzB,CAAC;AACJ,CAAC;AAED,yBAAyB;AACzB,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAkB,CAAC;IACjD,KAAK,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,44 @@
+import type { LegacyAnchor, LegacyAnchorRole, LegacyAnchorsFile } from './types.js';
+/** role 优先级(决策 #18:auto_resolve_cross_anchor=true 时用) */
+export declare const ROLE_PRIORITY: ReadonlyArray<LegacyAnchorRole>;
+/** 决策结果 */
+export interface ResolveResult {
+    /** 选中的 anchor(用于 LLM 输入) */
+    chosen: LegacyAnchor;
+    /** 决策依据 */
+    reason: 'sole-authoritative' | 'mtime-newer' | 'role-priority';
+    /** 同 role 其他被跳过的 anchor(authoritative=false 历史版) */
+    skipped?: LegacyAnchor[];
+}
+/**
+ * 同 role 多版本 → 选 authoritative=true 那条;无 authoritative=true → 抛错(决策 #10 schema 已挡)。
+ *
+ * 不返回多个、不返回 mtime 最新版(决策 #10 哲学:authoritative 是用户显式标的,不靠 mtime 推测)。
+ */
+export declare function resolveSameRole(anchors: LegacyAnchor[]): ResolveResult;
+/** 跨 role 决策入参 */
+export interface CrossRoleInput {
+    /** 文件 mtime(秒级时间戳),由 caller 传入(支持 mock) */
+    mtimeOf: (path: string) => number;
+    /** 是否走 auto_resolve(默认 false → 不决策,直接返回 'enter-diff') */
+    autoResolve: boolean;
+}
+/** 跨 role 决策结果 */
+export type CrossRoleDecision = {
+    kind: 'enter-diff';
+    conflictingRoles: LegacyAnchorRole[];
+} | {
+    kind: 'auto-resolved';
+    chosen: LegacyAnchor;
+    reason: 'mtime-newer' | 'role-priority';
+    losers: LegacyAnchor[];
+};
+/**
+ * 检测跨 role 冲突:对所有 authoritative=true 的 anchor 配对,
+ * caller 传入"两 anchor 是否冲突"的 predicate(LLM 在 sync-check 中判定);
+ * 这里只做"决策怎么处理冲突"的逻辑。
+ */
+export declare function decideCrossRole(conflicting: LegacyAnchor[], input: CrossRoleInput): CrossRoleDecision;
+/** 给定 anchors file 与 mtimeOf,返回所有 authoritative anchors 的"同 role 决策结果"列表 */
+export declare function resolveAuthoritativeForAllRoles(file: LegacyAnchorsFile): ResolveResult[];
+//# sourceMappingURL=conflict.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/conflict.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpF,yDAAyD;AACzD,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,gBAAgB,CAQzD,CAAC;AAEF,WAAW;AACX,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW;IACX,MAAM,EAAE,oBAAoB,GAAG,aAAa,GAAG,eAAe,CAAC;IAC/D,oDAAoD;IACpD,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,aAAa,CA2BtE;AAED,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,kBAAkB;AAClB,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,gBAAgB,EAAE,gBAAgB,EAAE,CAAA;CAAE,GAC5D;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,aAAa,GAAG,eAAe,CAAC;IACxC,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB,CAAC;AAEN;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,YAAY,EAAE,EAC3B,KAAK,EAAE,cAAc,GACpB,iBAAiB,CAyCnB;AAOD,4EAA4E;AAC5E,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,EAAE,CAQxF"}

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

@@ -0,0 +1,105 @@
+// 跨 anchor 一致性决策 — Plan 7 Phase B1
+// 决策 #18 修订:同 role 多版本 → authoritative=true 单选(无 diff);
+//                跨 role 不一致 → 默认入 diff(major 档);
+//                config.yaml#legacy_bridge.auto_resolve_cross_anchor=true 才走 mtime > role 优先级
+import { groupAnchorsByRole } from './anchors.js';
+/** role 优先级(决策 #18:auto_resolve_cross_anchor=true 时用) */
+export const ROLE_PRIORITY = [
+    'requirements', // 最高:SRS 是合同性边界
+    'high-level-design',
+    'low-level-design',
+    'system-tests',
+    'rationale',
+    'glossary',
+    'acceptance-report', // 最低:metadata-only,不参与决策
+];
+/**
+ * 同 role 多版本 → 选 authoritative=true 那条;无 authoritative=true → 抛错(决策 #10 schema 已挡)。
+ *
+ * 不返回多个、不返回 mtime 最新版(决策 #10 哲学:authoritative 是用户显式标的,不靠 mtime 推测)。
+ */
+export function resolveSameRole(anchors) {
+    if (anchors.length === 0) {
+        throw new Error('resolveSameRole: anchors 为空');
+    }
+    // I2 修:invariant 校验 — 函数语义是"同 role 多版本",防 caller 误传混 role 数组
+    // resolveAuthoritativeForAllRoles 通过 groupAnchorsByRole 保证安全;外部 caller 误用时显式抛错
+    const expectedRole = anchors[0].role;
+    if (anchors.some((a) => a.role !== expectedRole)) {
+        throw new Error(`resolveSameRole: 传入了混合 role 的 anchors(期望全为 '${expectedRole}')`);
+    }
+    const auth = anchors.filter((a) => a.authoritative);
+    if (auth.length === 1 && auth[0]) {
+        return {
+            chosen: auth[0],
+            reason: 'sole-authoritative',
+            skipped: anchors.filter((a) => !a.authoritative),
+        };
+    }
+    if (auth.length === 0) {
+        throw new Error(`resolveSameRole: role '${anchors[0]?.role}' 无 authoritative=true;请在 legacy-anchors.yaml 标当前版`);
+    }
+    // schema 校验已挡 multi-authoritative,这里 defensive
+    throw new Error(`resolveSameRole: role '${anchors[0]?.role}' 多个 authoritative=true(schema 应已拒)`);
+}
+/**
+ * 检测跨 role 冲突:对所有 authoritative=true 的 anchor 配对,
+ * caller 传入"两 anchor 是否冲突"的 predicate(LLM 在 sync-check 中判定);
+ * 这里只做"决策怎么处理冲突"的逻辑。
+ */
+export function decideCrossRole(conflicting, input) {
+    // I1 修:统一空数组防御(原本只在 autoResolve=true 路径检查,
+    // autoResolve=false 时 Set([]) 静默返空 enter-diff,Phase C 难诊断)
+    if (conflicting.length === 0) {
+        throw new Error('decideCrossRole: conflicting 为空');
+    }
+    // 决策 #18 修订:默认 enter-diff(major 档),不自动决策
+    if (!input.autoResolve) {
+        const roles = Array.from(new Set(conflicting.map((a) => a.role)));
+        return { kind: 'enter-diff', conflictingRoles: roles };
+    }
+    // auto_resolve_cross_anchor=true:走 mtime > role 优先级
+    let winner = conflicting[0]; // length>0 已防御
+    let winnerMtime = input.mtimeOf(winner.path);
+    // C1 修:reason 在循环内追踪,默认 role-priority;
+    // 出现 mtime 严格更大时锁定 mtime-newer。
+    // 原 allSameMtime 推断在 [mtime=100,mtime=100,mtime=50] 输入下误报 mtime-newer
+    // (winnerMtime=100 vs c.mtime=50 → allSameMtime=false → 错报),实际 winner 是 role-priority 选出。
+    let reason = 'role-priority';
+    for (const a of conflicting.slice(1)) {
+        const m = input.mtimeOf(a.path);
+        if (m > winnerMtime) {
+            winner = a;
+            winnerMtime = m;
+            reason = 'mtime-newer'; // 出现 mtime 严格大者就锁定
+        }
+        else if (m === winnerMtime) {
+            // mtime 相同 → role 优先级(数字小的优先);reason 不变(若已 mtime-newer 则保留)
+            if (rolePriorityIdx(a.role) < rolePriorityIdx(winner.role)) {
+                winner = a;
+            }
+        }
+    }
+    return {
+        kind: 'auto-resolved',
+        chosen: winner,
+        reason,
+        losers: conflicting.filter((a) => a !== winner),
+    };
+}
+function rolePriorityIdx(role) {
+    const idx = ROLE_PRIORITY.indexOf(role);
+    return idx === -1 ? ROLE_PRIORITY.length : idx;
+}
+/** 给定 anchors file 与 mtimeOf,返回所有 authoritative anchors 的"同 role 决策结果"列表 */
+export function resolveAuthoritativeForAllRoles(file) {
+    const grouped = groupAnchorsByRole(file);
+    const out = [];
+    for (const [, anchors] of grouped.entries()) {
+        if (anchors.length === 0)
+            continue;
+        out.push(resolveSameRole(anchors));
+    }
+    return out;
+}
+//# sourceMappingURL=conflict.js.map

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

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

package/dist/core/legacy-bridge/diff-report.d.ts

@@ -0,0 +1,14 @@
+import type { SyncStateFile, SyncStateDiff, DiffSeverity } from './types.js';
+/** 严重度排序(渲染顺序:critical → info) */
+export declare const SEVERITY_ORDER: ReadonlyArray<DiffSeverity>;
+/** 把 SyncStateFile 渲染为 markdown(human-readable) */
+export declare function renderDiffMarkdown(file: SyncStateFile): string;
+/** 把 SyncStateFile 渲染为 YAML(machine-readable + 用户编辑入口) */
+export declare function renderDiffYaml(file: SyncStateFile): string;
+/** diffs 按 severity 分组计数 */
+export declare function countBySeverity(diffs: SyncStateDiff[]): Record<DiffSeverity, number>;
+/** 是否含 critical 未 resolve 项(determines preflight 是否阻塞) */
+export declare function hasCriticalPending(file: SyncStateFile): boolean;
+/** 给定 LLM 输出 yaml 草稿,补全 status 字段(默认 pending) */
+export declare function normalizeDiffsFromLlm(diffs: Array<Partial<SyncStateDiff>>): SyncStateDiff[];
+//# sourceMappingURL=diff-report.d.ts.map

package/dist/core/legacy-bridge/diff-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-report.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/diff-report.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE7E,kCAAkC;AAClC,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,YAAY,CAMtD,CAAC;AAWF,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAuD9D;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAE1D;AAED,4BAA4B;AAC5B,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAYpF;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAE/D;AAED,iDAAiD;AACjD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,aAAa,EAAE,CAU3F"}

package/dist/core/legacy-bridge/diff-report.js

@@ -0,0 +1,105 @@
+// 5 档严重度差异报告渲染 — Plan 7 Phase C
+// 决策 #5:critical / major / minor / style / info;markdown + YAML 双栈
+import { stringify as stringifyYaml } from 'yaml';
+/** 严重度排序(渲染顺序:critical → info) */
+export const SEVERITY_ORDER = [
+    'critical',
+    'major',
+    'minor',
+    'style',
+    'info',
+];
+/** 严重度图标 */
+const SEVERITY_ICON = {
+    critical: '🔴',
+    major: '🟠',
+    minor: '🟡',
+    style: '🔵',
+    info: '⚪',
+};
+/** 把 SyncStateFile 渲染为 markdown(human-readable) */
+export function renderDiffMarkdown(file) {
+    const lines = [];
+    lines.push(`# Sync 差异报告:${file.change_id}`);
+    lines.push('');
+    lines.push(`生成时间:${file.generated_at}`);
+    lines.push('');
+    const counts = countBySeverity(file.diffs);
+    const summary = SEVERITY_ORDER.map((s) => `${SEVERITY_ICON[s]} ${s}: ${counts[s]}`).join('  ');
+    lines.push(`**总览**:${summary}`);
+    lines.push('');
+    if (file.cross_anchor_conflicts && file.cross_anchor_conflicts.length > 0) {
+        lines.push(`> ⚠ 跨 anchor 冲突 ${file.cross_anchor_conflicts.length} 项默认入 diff(决策 #18 修订)`);
+        lines.push('');
+    }
+    for (const severity of SEVERITY_ORDER) {
+        const items = file.diffs.filter((d) => d.severity === severity);
+        if (items.length === 0)
+            continue;
+        lines.push(`## ${SEVERITY_ICON[severity]} ${severity} (${items.length})`);
+        lines.push('');
+        for (const d of items) {
+            lines.push(`### #${d.id} \`${d.anchor_path}\`${d.section ? ` ${d.section}` : ''}`);
+            lines.push('');
+            lines.push(d.description);
+            lines.push('');
+            lines.push(`**status**:\`${d.status}\`${d.reason ? ` — ${d.reason}` : ''}`);
+            lines.push('');
+        }
+    }
+    if (file.cross_anchor_conflicts && file.cross_anchor_conflicts.length > 0) {
+        lines.push(`## 跨 anchor 不一致(决策 #18 修订)`);
+        lines.push('');
+        for (const d of file.cross_anchor_conflicts) {
+            lines.push(`### #${d.id} ${d.anchor_path}`);
+            lines.push('');
+            lines.push(d.description);
+            lines.push('');
+            lines.push(`**status**:\`${d.status}\``);
+            lines.push('');
+        }
+    }
+    lines.push('---');
+    lines.push('');
+    lines.push('## resolve 流程(决策 #19)');
+    lines.push('');
+    lines.push('1. 用户根据上述 diffs 决定:更新老文档 / false-positive / skipped');
+    lines.push('2. 编辑同名 `.yaml` 文件,把每条 status 字段从 `pending` 改为对应值');
+    lines.push('3. 跑 `forge legacy-bridge resolve <change-id>` 校验全部已 ack');
+    return lines.join('\n');
+}
+/** 把 SyncStateFile 渲染为 YAML(machine-readable + 用户编辑入口) */
+export function renderDiffYaml(file) {
+    return stringifyYaml(file);
+}
+/** diffs 按 severity 分组计数 */
+export function countBySeverity(diffs) {
+    const out = {
+        critical: 0,
+        major: 0,
+        minor: 0,
+        style: 0,
+        info: 0,
+    };
+    for (const d of diffs) {
+        out[d.severity] += 1;
+    }
+    return out;
+}
+/** 是否含 critical 未 resolve 项(determines preflight 是否阻塞) */
+export function hasCriticalPending(file) {
+    return file.diffs.some((d) => d.severity === 'critical' && d.status === 'pending');
+}
+/** 给定 LLM 输出 yaml 草稿,补全 status 字段(默认 pending) */
+export function normalizeDiffsFromLlm(diffs) {
+    return diffs.map((d, idx) => ({
+        id: d.id ?? idx + 1,
+        severity: (d.severity ?? 'info'),
+        anchor_path: d.anchor_path ?? '',
+        section: d.section,
+        description: d.description ?? '',
+        status: (d.status ?? 'pending'),
+        reason: d.reason,
+    }));
+}
+//# sourceMappingURL=diff-report.js.map

package/dist/core/legacy-bridge/diff-report.js.map

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

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

@@ -0,0 +1,42 @@
+import type { LegacyAnchor } from './types.js';
+/** 读文件结果,含原始字节用于 dry-run 时探测疑似编码 */
+export interface ReadAnchorResult {
+    /** UTF-8 字符串内容 */
+    text: string;
+    /** 原始字节(dry-run 时用于探测) */
+    raw: Buffer;
+    /** 是否含 mojibake 嫌疑(简易 heuristic:含 U+FFFD 替换字符) */
+    hasMojibake: boolean;
+    /** 行尾(LF / CRLF) */
+    lineEnding: 'LF' | 'CRLF' | 'mixed' | 'none';
+}
+/**
+ * 把 anchor 文件读为 LLM 输入文本(支持 .md / .txt / .csv / .xlsx)。
+ *
+ * 路径以 .xlsx 结尾时走 exceljs 解析 + 转 markdown 表格;
+ * 其他扩展名走 readAnchorFile(纯 utf8 文本)。
+ *
+ * spec §6.5 + 决策 §4.1:Excel 含 chart / pivot / formula 等不支持特性时抛 ExcelParseError,
+ * 引导用户在 Excel 另存为 .csv 后改 anchors.yaml。
+ *
+ * 提取自 Plan 7 Phase B(原各 caller 私有 helper),Phase F follow-up 统一公共入口
+ * 让 dry-run / index / regenerate 三个路径走同一逻辑(避免 dry-run 不真 parse Excel)。
+ */
+export declare function readAnchorAsText(anchor: LegacyAnchor): Promise<string>;
+/** 强制以 utf8 读老文档(spec §4.1 强制 encoding: utf8) */
+export declare function readAnchorFile(path: string): Promise<ReadAnchorResult>;
+/** 检测行尾(见 fixture tests/fixtures/legacy-bridge/windows-crlf-srs.md) */
+export declare function detectLineEnding(text: string): ReadAnchorResult['lineEnding'];
+/** dry-run 时调,用 chardet(可选依赖)探测疑似编码 + 输出 mojibake 段前后 80 字节对照 */
+export interface EncodingDryRunReport {
+    path: string;
+    detectedEncoding: string;
+    mojibakeContext?: string;
+}
+/**
+ * 用 chardet 探测疑似编码(可选依赖,缺失时 detectedEncoding='chardet-not-installed';
+ * 运行时错误时 detectedEncoding='chardet-error: <msg>')。
+ * spec §4.1 (M-3) dry-run 输出文件路径 + 疑似编码 + mojibake 段前后 80 字符 text + 80 字节 hex 对照。
+ */
+export declare function dryRunEncodingProbe(path: string, result: ReadAnchorResult): Promise<EncodingDryRunReport>;
+//# sourceMappingURL=encoding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/encoding.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,UAAU,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CAC9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB5E;AAED,iDAAiD;AACjD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAU5E;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAU7E;AAED,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAyC/B"}

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

@@ -0,0 +1,104 @@
+// 文件读取 + utf8 强制 + 可选 chardet 探测 — Plan 7 Phase B2
+// 决策 / spec §4.1:Windows 老项目常见 GBK 转 markdown,强制 utf8 读;mojibake 探测仅 dry-run 用
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { parseWorkbook, getSheet, sheetToMarkdown, ExcelParseError } from './excel.js';
+/**
+ * 把 anchor 文件读为 LLM 输入文本(支持 .md / .txt / .csv / .xlsx)。
+ *
+ * 路径以 .xlsx 结尾时走 exceljs 解析 + 转 markdown 表格;
+ * 其他扩展名走 readAnchorFile(纯 utf8 文本)。
+ *
+ * spec §6.5 + 决策 §4.1:Excel 含 chart / pivot / formula 等不支持特性时抛 ExcelParseError,
+ * 引导用户在 Excel 另存为 .csv 后改 anchors.yaml。
+ *
+ * 提取自 Plan 7 Phase B(原各 caller 私有 helper),Phase F follow-up 统一公共入口
+ * 让 dry-run / index / regenerate 三个路径走同一逻辑(避免 dry-run 不真 parse Excel)。
+ */
+export async function readAnchorAsText(anchor) {
+    const ext = extname(anchor.path).toLowerCase();
+    if (ext === '.xlsx') {
+        const wb = await parseWorkbook(anchor.path);
+        const sheet = getSheet(wb, anchor.sheet, anchor.path);
+        // 决策 §4.1:chart / pivot / formula 不支持时拒绝运行,引导导出 csv
+        if (sheet.unsupportedFeatures.length > 0) {
+            throw new ExcelParseError(`sheet '${sheet.name}' 含不支持特性(${sheet.unsupportedFeatures.join(', ')});请在 Excel 另存为 .csv 后改 anchors.yaml path 指向 .csv(决策 §4.1)`, anchor.path);
+        }
+        return sheetToMarkdown(sheet);
+    }
+    const r = await readAnchorFile(anchor.path);
+    return r.text;
+}
+/** 强制以 utf8 读老文档(spec §4.1 强制 encoding: utf8) */
+export async function readAnchorFile(path) {
+    // 读取原始字节
+    const raw = await readFile(path);
+    // 强制 utf8 解码
+    const text = raw.toString('utf8');
+    // 检测 mojibake 标记(U+FFFD 替换符)
+    const hasMojibake = /�/.test(text);
+    // 检测行尾类型
+    const lineEnding = detectLineEnding(text);
+    return { text, raw, hasMojibake, lineEnding };
+}
+/** 检测行尾(见 fixture tests/fixtures/legacy-bridge/windows-crlf-srs.md) */
+export function detectLineEnding(text) {
+    // 计数 CRLF
+    const crlf = (text.match(/\r\n/g) ?? []).length;
+    // 计数 LF(但不是 CRLF 的一部分,使用反向查断言)
+    const lfOnly = (text.match(/(?<!\r)\n/g) ?? []).length;
+    // 判断行尾类型
+    if (crlf === 0 && lfOnly === 0)
+        return 'none';
+    if (crlf > 0 && lfOnly > 0)
+        return 'mixed';
+    if (crlf > 0)
+        return 'CRLF';
+    return 'LF';
+}
+/**
+ * 用 chardet 探测疑似编码(可选依赖,缺失时 detectedEncoding='chardet-not-installed';
+ * 运行时错误时 detectedEncoding='chardet-error: <msg>')。
+ * spec §4.1 (M-3) dry-run 输出文件路径 + 疑似编码 + mojibake 段前后 80 字符 text + 80 字节 hex 对照。
+ */
+export async function dryRunEncodingProbe(path, result) {
+    let detectedEncoding = 'unknown';
+    try {
+        // chardet 是可选 devDep;运行时无则 fallback
+        const chardet = (await import('chardet'));
+        detectedEncoding = chardet.detect(result.raw) ?? 'unknown';
+    }
+    catch (e) {
+        // 区分模块缺失 vs 运行时错误,排查体验:用户看到 'chardet-not-installed' 时确知要装 chardet
+        const code = e.code;
+        if (code === 'ERR_MODULE_NOT_FOUND' ||
+            code === 'MODULE_NOT_FOUND' ||
+            code === 'ERR_CANNOT_FIND_MODULE') {
+            detectedEncoding = 'chardet-not-installed';
+        }
+        else {
+            detectedEncoding = `chardet-error: ${e.message}`;
+        }
+    }
+    let mojibakeContext;
+    if (result.hasMojibake) {
+        // 仅取第一处 mojibake 作 context 锚点;多处 mojibake 时 caller 可重跑或扩 dryRun API
+        const idx = result.text.indexOf('�');
+        const beforeText = result.text.slice(Math.max(0, idx - 80), idx);
+        const afterText = result.text.slice(idx, Math.min(result.text.length, idx + 80));
+        // byte offset 换算:utf8 编码的字节数(注意 mojibake 字符 U+FFFD 在 utf8 是 3 字节,原始字节可能是任意 1-2 字节,
+        // 这里给的是 mojibake-after-decode 视角下的 byte 位置,作 hex dump 锚点;实际原始 GBK 字节序与该位置略有偏移属可接受)
+        const byteIdx = Buffer.byteLength(result.text.slice(0, idx), 'utf8');
+        const beforeHex = result.raw.subarray(Math.max(0, byteIdx - 80), byteIdx).toString('hex');
+        const afterHex = result.raw
+            .subarray(byteIdx, Math.min(result.raw.length, byteIdx + 80))
+            .toString('hex');
+        mojibakeContext =
+            `[before 80 text]: ${JSON.stringify(beforeText)}\n` +
+                `[before 80 hex]:  ${beforeHex}\n` +
+                `[after 80 text]:  ${JSON.stringify(afterText)}\n` +
+                `[after 80 hex]:   ${afterHex}`;
+    }
+    return { path, detectedEncoding, mojibakeContext };
+}
+//# sourceMappingURL=encoding.js.map

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

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

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

@@ -0,0 +1,32 @@
+/** 单 sheet 解析结果 */
+export interface SheetResult {
+    name: string;
+    rows: string[][];
+    /** 是否含 chart / pivot / formula(spec §6.5 v0.2 不支持) */
+    unsupportedFeatures: string[];
+}
+/** 整个 workbook 解析结果 */
+export interface WorkbookResult {
+    sheets: SheetResult[];
+}
+/** 自定义异常:Excel 解析失败或含不支持特性(供 CLI 转 exit 2) */
+export declare class ExcelParseError extends Error {
+    readonly path: string;
+    constructor(message: string, path: string);
+}
+/**
+ * 用 exceljs 读 .xlsx,返回所有 sheet 的行二维数组。
+ *
+ * - chart / pivotTable 等不支持特性 → 标 unsupportedFeatures(caller 决定是 fail 还是 warn)
+ * - formula → 读 result(已计算值)而不是 formula 表达式
+ * - 损坏 / 空 workbook → 抛 ExcelParseError
+ */
+export declare function parseWorkbook(path: string): Promise<WorkbookResult>;
+/** 取指定 sheet(若 sheet 不存在 → 抛错;sheet=undefined → 取第一个) */
+export declare function getSheet(result: WorkbookResult, sheet: string | undefined, pathForError: string): SheetResult;
+/**
+ * 把 sheet 转成简单 markdown 表(供 LLM 输入)。
+ * 第 1 行作 header(若 rows 非空)。
+ */
+export declare function sheetToMarkdown(sheet: SheetResult): string;
+//# sourceMappingURL=excel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"excel.d.ts","sourceRoot":"","sources":["../../../src/core/legacy-bridge/excel.ts"],"names":[],"mappings":"AAKA,mBAAmB;AACnB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB,sDAAsD;IACtD,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,uBAAuB;AACvB,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,8CAA8C;AAC9C,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAK/B;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAuEzE;AAED,yDAAyD;AACzD,wBAAgB,QAAQ,CACtB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,YAAY,EAAE,MAAM,GACnB,WAAW,CAcb;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAW1D"}