soloforge 1.1.53 → 1.1.55

package/dist/shared/diagnostic_registry.js

@@ -11,258 +11,5 @@
  * 数据流：审计输入（代码/配置） → 检查 → 评分/报告
  * 持久化：无持久化（纯计算/内存态）
  */
-export const TOOL_DIAGNOSTIC_CODES = {
-    planGate: "SF-PLAN-5001",
-    instructionContract: "SF-INSTR-5801",
-    oodMissingSummary: "SF-OOD-6601",
-    oodDeliveryBlock: "SF-OOD-6602",
-    backendMissingSummary: "SF-BACKEND-6701",
-    backendDeliveryBlock: "SF-BACKEND-6702",
-    codeObservabilityWorkPackage: "SF-OBS-6801",
-    codeObservabilityFinding: "SF-OBS-6802",
-    projectKnowledgeBlocked: "SF-PK-6901",
-    contractDraft: "SF-CONTRACT-0003",
-    verifyPlanMismatch: "SF-VERIFY-5002",
-};
-const BUILTIN_DIAGNOSTICS = [
-    // STATE 领域
-    { code: "SF-STATE-0001", area: "STATE", severity: "blocking", status: "active",
-        title_zh: "非法状态转移: failed → completed",
-        user_message_zh: "任务已失败，不能直接标记完成。需要人工确认恢复后重新验证。",
-        recovery_hint_zh: "检查失败原因，修复后重新执行验证流程。",
-        owner_component: "engine/task_context", evidence_refs: ["task_context状态机"] },
-    { code: "SF-STATE-0002", area: "STATE", severity: "blocking", status: "active",
-        title_zh: "非法状态转移: blocked → completed",
-        user_message_zh: "任务被阻断，不能直接标记完成。需要解除阻断条件。",
-        recovery_hint_zh: "检查阻断原因，解决阻断条件后重试。",
-        owner_component: "engine/task_context", evidence_refs: ["task_context状态机"] },
-    { code: "SF-STATE-0003", area: "STATE", severity: "blocking", status: "active",
-        title_zh: "非法状态转移: requires_human → completed",
-        user_message_zh: "任务需要人工确认，不能自动标记完成。",
-        recovery_hint_zh: "等待人工确认后继续。",
-        owner_component: "engine/task_context", evidence_refs: ["task_context状态机"] },
-    // GUARD 领域
-    { code: "SF-GUARD-0001", area: "GUARD", severity: "blocking", status: "active",
-        title_zh: "只读工作流写入业务源码",
-        user_message_zh: "当前工作流不允许写入业务源码，操作已阻断。",
-        recovery_hint_zh: "检查路由是否正确，或切换到允许写入的工作流。",
-        owner_component: "engine/enforcement_guard", evidence_refs: ["enforcement_guard写入护栏"] },
-    { code: "SF-GUARD-0002", area: "GUARD", severity: "blocking", status: "active",
-        title_zh: "超出 output artifact 范围写入",
-        user_message_zh: "source_extraction 工作流只能写入指定的 output artifact 路径。",
-        recovery_hint_zh: "确认输出路径是否在允许范围内。",
-        owner_component: "engine/enforcement_guard", evidence_refs: ["enforcement_guard范围护栏"] },
-    { code: "SF-GUARD-0003", area: "GUARD", severity: "blocking", status: "active",
-        title_zh: "破坏性命令未经人工确认",
-        user_message_zh: "检测到破坏性命令（如删除、覆盖）但缺少人工确认。操作已阻止。",
-        recovery_hint_zh: "请通过 sf_task confirm 确认执行，或调整命令为非破坏性操作。",
-        owner_component: "engine/enforcement_guard", evidence_refs: ["enforcement_guard执行护栏"] },
-    { code: "SF-GUARD-0004", area: "GUARD", severity: "blocking", status: "active",
-        title_zh: "不可注入知识条目被注入到 prompt",
-        user_message_zh: "知识条目的 status 或 scope 不允许注入，但被尝试注入。操作已阻止。",
-        recovery_hint_zh: "检查知识条目的 lifecycle status 和 injection 权限。",
-        owner_component: "engine/enforcement_guard", evidence_refs: ["enforcement_guard知识护栏"] },
-    { code: "SF-GUARD-0005", area: "GUARD", severity: "blocking", status: "active",
-        title_zh: "prompt 超出工作流契约权限",
-        user_message_zh: "当前工作流不允许此 prompt 内容或权限级别。操作已阻止。",
-        recovery_hint_zh: "检查工作流契约的 prompt 权限配置。",
-        owner_component: "engine/enforcement_guard", evidence_refs: ["enforcement_guard prompt护栏"] },
-    { code: "SF-GUARD-0006", area: "GUARD", severity: "blocking", status: "active",
-        title_zh: "外部副作用无 evidence 记录",
-        user_message_zh: "检测到外部副作用操作（push/PR/deploy）但缺少 evidence 记录。",
-        recovery_hint_zh: "确保所有外部副作用操作有完整的 evidence chain。",
-        owner_component: "engine/enforcement_guard", evidence_refs: ["enforcement_guard副作用护栏"] },
-    // VERIFY 领域
-    { code: "SF-VERIFY-0001", area: "VERIFY", severity: "critical", status: "active",
-        title_zh: "验证计划被当作验证证据",
-        user_message_zh: "检测到只有验证计划没有验证结果。计划不得替代真实执行。",
-        recovery_hint_zh: "执行验证命令获取真实结果。",
-        owner_component: "engine/verification_contract", evidence_refs: ["verification_contract分离"] },
-    { code: "SF-VERIFY-0002", area: "VERIFY", severity: "blocking", status: "active",
-        title_zh: "未验证但尝试交付",
-        user_message_zh: "任务未通过验证，不允许交付。",
-        recovery_hint_zh: "先完成验证流程，确保所有检查通过。",
-        owner_component: "engine/delivery_readiness", evidence_refs: ["delivery_readiness门控"] },
-    // FAILURE 领域
-    { code: "SF-FAILURE-0001", area: "FAILURE", severity: "critical", status: "active",
-        title_zh: "重试预算耗尽",
-        user_message_zh: "失败重试次数已达上限，需要人工介入。",
-        recovery_hint_zh: "检查错误根因，手动修复后重新执行。",
-        owner_component: "engine/recovery_policy", evidence_refs: ["recovery_policy预算"] },
-    { code: "SF-FAILURE-0002", area: "FAILURE", severity: "warning", status: "active",
-        title_zh: "外部副作用部分执行",
-        user_message_zh: "检测到外部副作用部分执行，已记录已发生动作。",
-        recovery_hint_zh: "检查已执行副作用，确认是否需要回滚。",
-        owner_component: "engine/recovery_policy", evidence_refs: ["recovery_policy副作用"] },
-    // DEGRADE 领域
-    { code: "SF-DEGRADE-0001", area: "DEGRADE", severity: "warning", status: "active",
-        title_zh: "验证器不可用，降级运行",
-        user_message_zh: "验证器不可用，当前为降级模式。结果未经验证。",
-        recovery_hint_zh: "等待验证器恢复后重新验证，或人工确认。",
-        owner_component: "engine/degradation", evidence_refs: ["degradation降级"] },
-    // WORKSPACE 领域
-    { code: "SF-WORKSPACE-0001", area: "WORKSPACE", severity: "blocking", status: "active",
-        title_zh: "并发写入冲突",
-        user_message_zh: "检测到其他任务正在写入相同文件范围，操作已阻断。",
-        recovery_hint_zh: "等待其他任务完成或人工协调写入顺序。",
-        owner_component: "engine/workspace_lease", evidence_refs: ["workspace_lease冲突"] },
-    // OBSERVE 领域
-    { code: "SF-OBSERVE-0001", area: "OBSERVE", severity: "warning", status: "active",
-        title_zh: "TaskContext 尝试存储敏感原文",
-        user_message_zh: "检测到尝试将敏感信息存入 TaskContext，已自动脱敏。",
-        recovery_hint_zh: "确认脱敏后的内容是否满足需求。",
-        owner_component: "engine/task_context", evidence_refs: ["task_context边界"] },
-    // CONTRACT 领域
-    { code: "SF-CONTRACT-0001", area: "CONTRACT", severity: "blocking", status: "active",
-        title_zh: "引用已废弃/已移除的契约",
-        user_message_zh: "工作流引用了已废弃或已移除的契约，操作已阻断。",
-        recovery_hint_zh: "迁移到替代契约或更新工作流配置。",
-        owner_component: "engine/contract_registry", evidence_refs: ["contract_registry门控"] },
-    // PRIVACY 领域
-    { code: "SF-PRIVACY-0001", area: "PRIVACY", severity: "blocking", status: "active",
-        title_zh: "命令输出包含敏感信息",
-        user_message_zh: "命令执行输出检测到敏感信息，已自动脱敏存储。",
-        recovery_hint_zh: "检查脱敏后内容，确认是否需要重新执行。",
-        owner_component: "engine/privacy_secret_contract", evidence_refs: ["privacy脱敏"] },
-    { code: TOOL_DIAGNOSTIC_CODES.planGate, area: "GUARD", severity: "blocking", status: "active",
-        title_zh: "写工具缺少计划前置门",
-        user_message_zh: "写入类工具执行前缺少已确认的计划。",
-        recovery_hint_zh: "先完成 sf_task → sf_work，并确认执行计划。",
-        owner_component: "server/tools", evidence_refs: ["PlanProposalFirstGate"] },
-    { code: TOOL_DIAGNOSTIC_CODES.instructionContract, area: "CONTRACT", severity: "blocking", status: "active",
-        title_zh: "施工指令契约未就绪",
-        user_message_zh: "施工指令缺少目标、范围、验收或禁止绕过项。",
-        recovery_hint_zh: "补齐施工指令后再执行写入。",
-        owner_component: "engine/instruction_contract", evidence_refs: ["InstructionContract"] },
-    { code: TOOL_DIAGNOSTIC_CODES.oodMissingSummary, area: "CONTRACT", severity: "blocking", status: "active",
-        title_zh: "OOD/SOLID 摘要缺失",
-        user_message_zh: "复杂实现任务缺少面向对象与 SOLID 设计摘要。",
-        recovery_hint_zh: "先补齐职责、依赖方向、扩展点和边界说明。",
-        owner_component: "engine/ood_solid_contract", evidence_refs: ["OOD/SOLID契约"] },
-    { code: TOOL_DIAGNOSTIC_CODES.oodDeliveryBlock, area: "DELIVER", severity: "blocking", status: "active",
-        title_zh: "OOD/SOLID 问题未闭合",
-        user_message_zh: "实现仍存在职责、依赖或扩展性硬失败，不能交付。",
-        recovery_hint_zh: "修复 OOD/SOLID finding 后重新验证。",
-        owner_component: "engine/ood_solid_contract", evidence_refs: ["OOD/SOLID交付门"] },
-    { code: TOOL_DIAGNOSTIC_CODES.backendMissingSummary, area: "CONTRACT", severity: "blocking", status: "active",
-        title_zh: "后端工程契约摘要缺失",
-        user_message_zh: "后端实现缺少参数、事务、权限、幂等或审计等工程契约。",
-        recovery_hint_zh: "补齐后端实现工作包后再编码。",
-        owner_component: "engine/backend_implementation_contract", evidence_refs: ["后端工程契约"] },
-    { code: TOOL_DIAGNOSTIC_CODES.backendDeliveryBlock, area: "DELIVER", severity: "blocking", status: "active",
-        title_zh: "后端工程契约未闭合",
-        user_message_zh: "后端实现仍存在参数校验、事务、安全或审计硬失败，不能交付。",
-        recovery_hint_zh: "修复后端工程 finding 后重新验证。",
-        owner_component: "engine/backend_implementation_contract", evidence_refs: ["后端工程交付门"] },
-    { code: TOOL_DIAGNOSTIC_CODES.codeObservabilityWorkPackage, area: "OBSERVE", severity: "blocking", status: "active",
-        title_zh: "代码可维护性与可观测性工作包缺失",
-        user_message_zh: "业务编码前缺少必要注释、日志和脱敏约束。",
-        recovery_hint_zh: "先生成并确认代码可维护性与可观测性工作包。",
-        owner_component: "engine/code_maintainability_observability_contract", evidence_refs: ["问题六十八"] },
-    { code: TOOL_DIAGNOSTIC_CODES.codeObservabilityFinding, area: "OBSERVE", severity: "blocking", status: "active",
-        title_zh: "代码可维护性与可观测性 finding 未闭合",
-        user_message_zh: "代码存在敏感日志、不可定位日志、吞异常或关键操作缺日志，不能交付。",
-        recovery_hint_zh: "修复注释/日志 finding 后重新验证。",
-        owner_component: "engine/code_maintainability_observability_contract", evidence_refs: ["问题六十八"] },
-    { code: TOOL_DIAGNOSTIC_CODES.projectKnowledgeBlocked, area: "CONTRACT", severity: "blocking", status: "active",
-        title_zh: "用户项目知识规则不可消费",
-        user_message_zh: "项目 .soloforge/knowledge 中存在 hard rule 路由、触发条件或身份冲突，不能进入执行、审查、验证或交付。",
-        recovery_hint_zh: "运行 sf_knowledge action=audit，修复规则 frontmatter、routes、triggers 或冲突后重试。",
-        owner_component: "context/contracts/project_knowledge_contract", evidence_refs: ["用户项目知识消费体系"] },
-    { code: TOOL_DIAGNOSTIC_CODES.contractDraft, area: "CONTRACT", severity: "blocking", status: "active",
-        title_zh: "设计产物仍为草稿",
-        user_message_zh: "设计产物未通过契约验证或仍是草稿，不能交付。",
-        recovery_hint_zh: "修复设计产物后重新执行阶段工具，确定性门禁自动复验。",
-        owner_component: "engine/standard_asset_contract", evidence_refs: ["标准资产契约"] },
-    { code: TOOL_DIAGNOSTIC_CODES.verifyPlanMismatch, area: "VERIFY", severity: "blocking", status: "active",
-        title_zh: "验证计划不匹配",
-        user_message_zh: "请求的验证计划与当前任务计划不一致。",
-        recovery_hint_zh: "使用当前任务的 plan_id 重新执行验证。",
-        owner_component: "server/tools", evidence_refs: ["VerificationPlan"] },
-];
-let runtimeDiagnostics = null;
-function getRegistry() {
-    if (!runtimeDiagnostics) {
-        runtimeDiagnostics = new Map();
-        for (const entry of BUILTIN_DIAGNOSTICS) {
-            runtimeDiagnostics.set(entry.code, { ...entry });
-        }
-    }
-    return runtimeDiagnostics;
-}
-/** 按 code 获取诊断码 */
-export function getDiagnosticByCode(code) {
-    return getRegistry().get(code);
-}
-/** 列出所有诊断码 */
-export function listAllDiagnostics() {
-    return [...getRegistry().values()];
-}
-/** 按领域列出诊断码 */
-export function listDiagnosticsByArea(area) {
-    return [...getRegistry().values()].filter((d) => d.area === area);
-}
-/** 按 severity 列出诊断码 */
-export function listDiagnosticsBySeverity(severity) {
-    return [...getRegistry().values()].filter((d) => d.severity === severity);
-}
-/** 注册新诊断码（运行时） */
-export function registerDiagnostic(entry) {
-    const registry = getRegistry();
-    if (registry.has(entry.code)) {
-        return { success: false, error: `诊断码 ${entry.code} 已存在` };
-    }
-    if (!/^SF-[A-Z]+-\d{4}$/.test(entry.code)) {
-        return { success: false, error: `诊断码格式错误: ${entry.code}，必须为 SF-{AREA}-{NNNN}` };
-    }
-    if (!entry.title_zh || !entry.user_message_zh || !entry.recovery_hint_zh) {
-        return { success: false, error: "诊断码必须有 title_zh、user_message_zh、recovery_hint_zh" };
-    }
-    registry.set(entry.code, { ...entry });
-    return { success: true };
-}
-/** 创建诊断事件 */
-export function createDiagnosticEvent(code, context, contractId, taskId) {
-    const entry = getRegistry().get(code);
-    if (!entry)
-        return null;
-    if (entry.status === "deprecated" || entry.status === "removed")
-        return null;
-    return {
-        code,
-        occurred_at: new Date().toISOString(),
-        context: context ?? {},
-        user_visible_message: entry.user_message_zh,
-        contract_id: contractId,
-        task_id: taskId,
-    };
-}
-/** 验证所有 blocking/critical 事件必须有诊断码 */
-export function validateDiagnosticCoverage(eventSeverities) {
-    const errors = [];
-    for (const event of eventSeverities) {
-        if ((event.severity === "blocking" || event.severity === "critical") && !event.has_code) {
-            errors.push({
-                severity: event.severity,
-                error: `${event.severity} 事件缺少诊断码`,
-            });
-        }
-    }
-    return errors;
-}
-/** 重置注册表（测试用） */
-export function resetDiagnosticRegistry() {
-    runtimeDiagnostics = null;
-}
-/** 获取诊断码统计 */
-export function getDiagnosticStats() {
-    const entries = [...getRegistry().values()];
-    const by_area = {};
-    const by_severity = {};
-    for (const e of entries) {
-        by_area[e.area] = (by_area[e.area] ?? 0) + 1;
-        by_severity[e.severity] = (by_severity[e.severity] ?? 0) + 1;
-    }
-    return { total: entries.length, by_area, by_severity };
-}
+export {};
 //# sourceMappingURL=diagnostic_registry.js.map

package/dist/shared/diagnostic_registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostic_registry.js","sourceRoot":"","sources":["../../src/shared/diagnostic_registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"diagnostic_registry.js","sourceRoot":"","sources":["../../src/shared/diagnostic_registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/shared/glob_path.d.ts

@@ -2,16 +2,16 @@
  * glob_path — 核心基础层模块。
  *
  * 职责边界：
- * - 负责：轻量 glob 路径匹配（仅支持单段 `*`，不跨目录）与产物路径存在性判定
+ * - 负责：轻量 glob 路径匹配（支持多段 `*`，每段不跨目录）与产物路径存在性判定
  * - 不负责：完整 glob 引擎（`**` / `?` / `[]` 不支持），那些场景应引入专用库
  *
- * 被谁调用：原型说明多端路径（`docs/analyze/{端}/01-原型说明.md`）等带通配符的产物路径检查
+ * 被谁调用：原型说明多端路径（`docs/analyze/{端}/pages/{页}-原型说明.md`）等带通配符的产物路径检查
  * 调用谁：node:fs、node:path
  *
  * 数据流：glob 模式 → 字符串匹配 / 文件系统遍历 → 命中结果
  * 持久化：无持久化（纯计算 / 只读文件系统）
  *
- * 设计说明：原型说明等多端产物的 glob 模式是固定单层（`*` 不跨目录），
+ * 设计说明：原型说明等多端产物的 glob 模式可含多段 `*`（每段不跨目录，如 docs/analyze/{端}/pages/{页}-原型说明.md），
  * 不需要完整 glob 引擎。本模块采用自研的递归遍历思路，
  * 零第三方依赖、保持 engines.node >=18 兼容。
  */

package/dist/shared/glob_path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glob_path.d.ts","sourceRoot":"","sources":["../../src/shared/glob_path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAWH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/C;AAwBD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAIpE;AA2CD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAU5E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAUjF"}
+{"version":3,"file":"glob_path.d.ts","sourceRoot":"","sources":["../../src/shared/glob_path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAWH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/C;AAwBD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAIpE;AA2CD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAW5E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWjF"}

package/dist/shared/glob_path.js

@@ -2,16 +2,16 @@
  * glob_path — 核心基础层模块。
  *
  * 职责边界：
- * - 负责：轻量 glob 路径匹配（仅支持单段 `*`，不跨目录）与产物路径存在性判定
+ * - 负责：轻量 glob 路径匹配（支持多段 `*`，每段不跨目录）与产物路径存在性判定
  * - 不负责：完整 glob 引擎（`**` / `?` / `[]` 不支持），那些场景应引入专用库
  *
- * 被谁调用：原型说明多端路径（`docs/analyze/{端}/01-原型说明.md`）等带通配符的产物路径检查
+ * 被谁调用：原型说明多端路径（`docs/analyze/{端}/pages/{页}-原型说明.md`）等带通配符的产物路径检查
  * 调用谁：node:fs、node:path
  *
  * 数据流：glob 模式 → 字符串匹配 / 文件系统遍历 → 命中结果
  * 持久化：无持久化（纯计算 / 只读文件系统）
  *
- * 设计说明：原型说明等多端产物的 glob 模式是固定单层（`*` 不跨目录），
+ * 设计说明：原型说明等多端产物的 glob 模式可含多段 `*`（每段不跨目录，如 docs/analyze/{端}/pages/{页}-原型说明.md），
  * 不需要完整 glob 引擎。本模块采用自研的递归遍历思路，
  * 零第三方依赖、保持 engines.node >=18 兼容。
  */
@@ -44,7 +44,7 @@ function globToRegExpSource(pattern) {
         if (ch === "*") {
             src += "[^/]*";
         }
-        else if (/[$^()+.\\|{}]/.test(ch)) {
+        else if (/[$^()+.\\|{}[\]]/.test(ch)) {
             src += "\\" + ch;
         }
         else {
@@ -66,7 +66,7 @@ export function matchGlob(filePath, pattern) {
 }
 /**
  * 从 glob 模式提取首个 `*` 之前的固定目录前缀（相对 rootDir）。
- * 例：`docs/analyze/{端}/01-原型说明.md` → `docs/analyze`（只遍历该子树，避免扫全项目）。
+ * 例：`docs/analyze/{端}/pages/{页}-原型说明.md` → `docs/analyze`（只遍历该子树，避免扫全项目）。
  */
 function globSearchSubdir(pattern) {
     const starIdx = pattern.indexOf("*");
@@ -114,6 +114,8 @@ function collectFilesFrom(rootDir, searchSubdir) {
  * - pattern 含 `?` / `[`：保守按字面 existsSync（不误判）
  */
 export function artifactPathExists(rootDir, pattern) {
+    if (!pattern || pattern.trim() === "")
+        return false; // 空 pattern 防护：path.join(root,"")=root → existsSync 恒 true（假存在，绕过产物门禁）
     if (!containsGlob(pattern)) {
         return fs.existsSync(path.join(rootDir, pattern));
     }
@@ -132,6 +134,8 @@ export function artifactPathExists(rootDir, pattern) {
  * - pattern 含 `?` / `[`：保守按字面
  */
 export function resolveArtifactsByGlob(rootDir, pattern) {
+    if (!pattern || pattern.trim() === "")
+        return []; // 空 pattern 防护：避免返回 [""] 伪命中（loadUpstreamContent/loadArtifactAggregate 据此读文件）
     if (!containsGlob(pattern)) {
         return fs.existsSync(path.join(rootDir, pattern)) ? [pattern] : [];
     }

package/dist/shared/glob_path.js.map

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

package/dist/shared/helpers.d.ts

@@ -38,8 +38,10 @@ export declare function errorMessage(e: unknown): string;
 export declare function safeJsonParse<T>(text: string): T | undefined;
 export declare function safeJsonParse<T>(text: string, fallback: T): T;
 /**
- * 安全的 JSON 序列化 — 替代裸 `JSON.stringify()`。
- * 循环引用或其他错误时返回 fallback（默认 undefined）。
+ * 安全截断字符串 — 避免在 UTF-16 代理对中间截断导致乱码/损坏。
+ * JS 字符串是 UTF-16：emoji/扩展 CJK 等占两个码元（高位 0xD800-0xDBFF + 低位 0xDC00-0xDFFF）。
+ * str.slice(0,N) 按码元切，若 N 落在代理对中间会把高位孤悬 → 下游 JSON.stringify 抛错 / LLM 乱码。
+ * 截断处码元若在高代理位（下一码元是低代理却没配对）→ 退一位再拼 suffix。短于 max 原样返回。
  */
-export declare function safeJsonStringify(obj: unknown, fallback?: string): string | undefined;
+export declare function safeTruncate(str: string, max: number, suffix?: string): string;
 //# sourceMappingURL=helpers.d.ts.map

package/dist/shared/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/shared/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,wBAAgB,cAAc,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAW/C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;AAC9D,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;AAS/D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMrF"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/shared/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,wBAAgB,cAAc,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAW/C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;AAC9D,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;AAS/D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,CAK1E"}

package/dist/shared/helpers.js

@@ -46,15 +46,17 @@ export function safeJsonParse(text, fallback) {
     }
 }
 /**
- * 安全的 JSON 序列化 — 替代裸 `JSON.stringify()`。
- * 循环引用或其他错误时返回 fallback（默认 undefined）。
+ * 安全截断字符串 — 避免在 UTF-16 代理对中间截断导致乱码/损坏。
+ * JS 字符串是 UTF-16：emoji/扩展 CJK 等占两个码元（高位 0xD800-0xDBFF + 低位 0xDC00-0xDFFF）。
+ * str.slice(0,N) 按码元切，若 N 落在代理对中间会把高位孤悬 → 下游 JSON.stringify 抛错 / LLM 乱码。
+ * 截断处码元若在高代理位（下一码元是低代理却没配对）→ 退一位再拼 suffix。短于 max 原样返回。
  */
-export function safeJsonStringify(obj, fallback) {
-    try {
-        return JSON.stringify(obj);
-    }
-    catch {
-        return fallback;
-    }
+export function safeTruncate(str, max, suffix = "") {
+    if (str.length <= max)
+        return str;
+    let cut = max;
+    if (str.charCodeAt(max - 1) >= 0xd800 && str.charCodeAt(max - 1) <= 0xdbff)
+        cut = max - 1;
+    return str.slice(0, cut) + suffix;
 }
 //# sourceMappingURL=helpers.js.map

package/dist/shared/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/shared/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,UAAU,cAAc,CAAC,CAAmB;IAChD,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,CAAmB;IACjD,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAA2B,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QACvB,+CAA+C;QAC/C,8DAA8D;QAC9D,MAAM,GAAG,GAAG,CAAQ,CAAC;QACrB,IAAI,GAAG,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,GAAG,CAAC,CAAC,OAAO,WAAW,GAAG,CAAC,QAAQ,GAAG,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,CAAC,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAiBD,MAAM,UAAU,aAAa,CAAI,IAAY,EAAE,QAAY;IACzD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY,EAAE,QAAiB;IAC/D,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/shared/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,UAAU,cAAc,CAAC,CAAmB;IAChD,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,CAAmB;IACjD,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAA2B,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QACvB,+CAA+C;QAC/C,8DAA8D;QAC9D,MAAM,GAAG,GAAG,CAAQ,CAAC;QACrB,IAAI,GAAG,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,GAAG,CAAC,CAAC,OAAO,WAAW,GAAG,CAAC,QAAQ,GAAG,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,CAAC,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAiBD,MAAM,UAAU,aAAa,CAAI,IAAY,EAAE,QAAY;IACzD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,GAAW,EAAE,MAAM,GAAG,EAAE;IAChE,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAClC,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,MAAM;QAAE,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;IAC1F,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;AACpC,CAAC"}

package/dist/shared/knowledge_config_loader.d.ts

@@ -21,16 +21,4 @@ export declare function loadKnowledgeConfig(relativePath: string, projectPath?:
     data: Record<string, unknown>;
     body: string;
 } | null;
-/**
- * 从知识文件的决策规则中提取指定键的数值。
- */
-export declare function extractNumberRule(body: string, key: string): number | undefined;
-/** 从知识文件的决策规则中提取字符串值。 */
-export declare function extractStringRule(body: string, key: string): string | undefined;
-/** 从知识文件的决策规则中提取列表值（格式：键 = 值1 / 值2 / 值3）。 */
-export declare function extractListRule(body: string, key: string): string[];
-/**
- * 清除知识配置缓存（测试用）。
- */
-export declare function clearConfigCache(): void;
 //# sourceMappingURL=knowledge_config_loader.d.ts.map

package/dist/shared/knowledge_config_loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge_config_loader.d.ts","sourceRoot":"","sources":["../../src/shared/knowledge_config_loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwBH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoCxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI/E;AAED,yBAAyB;AACzB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI/E;AAED,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAInE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}
+{"version":3,"file":"knowledge_config_loader.d.ts","sourceRoot":"","sources":["../../src/shared/knowledge_config_loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwBH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoCxD"}

package/dist/shared/knowledge_config_loader.js

@@ -72,32 +72,4 @@ export function loadKnowledgeConfig(relativePath, projectPath) {
         return null;
     }
 }
-/**
- * 从知识文件的决策规则中提取指定键的数值。
- */
-export function extractNumberRule(body, key) {
-    const regex = new RegExp(`${key.replace(/_/g, "[_ ]")}\\s*=\\s*([\\d.]+)`, "i");
-    const match = body.match(regex);
-    return match ? parseFloat(match[1]) : undefined;
-}
-/** 从知识文件的决策规则中提取字符串值。 */
-export function extractStringRule(body, key) {
-    const regex = new RegExp(`${key.replace(/_/g, "[_ ]")}\\s*=\\s*([^\\n,]+)`, "i");
-    const match = body.match(regex);
-    return match ? match[1].trim() : undefined;
-}
-/** 从知识文件的决策规则中提取列表值（格式：键 = 值1 / 值2 / 值3）。 */
-export function extractListRule(body, key) {
-    const value = extractStringRule(body, key);
-    if (!value)
-        return [];
-    return value.split(/[/,，、]/).map((v) => v.trim()).filter(Boolean);
-}
-/**
- * 清除知识配置缓存（测试用）。
- */
-export function clearConfigCache() {
-    debug("CoreKnowledgeConfigLoader", "清除配置缓存");
-    configCache.clear();
-}
 //# sourceMappingURL=knowledge_config_loader.js.map

package/dist/shared/knowledge_config_loader.js.map

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

package/dist/shared/write_file_atomic.d.ts

@@ -14,6 +14,12 @@
 /**
  * 同步原子写入：先写 .tmp 再 rename。
  *
+ * **并发安全范围**（适用所有 atomicWriteFile* 调用方，含 *_store.ts）：
+ * - 进程内原子（read 看不到半写文件，单线程运行时串行）
+ * - **跨进程不安全**：两进程 read-modify-rename 同文件，后者覆盖前者且无异常（[[init_must_not_parallel]] 根害）
+ * - 随机 tmp 后缀只防 tmp 碰撞，不序列化最终 rename
+ * 跨进程共享文件（init 全局 patterns / 2 个 MCP 服务器同项目）须外部串行。
+ *
  * @param filePath - 目标文件路径
  * @param content - 要写入的内容
  * @param encoding - 编码，默认 "utf-8"

package/dist/shared/write_file_atomic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write_file_atomic.d.ts","sourceRoot":"","sources":["../../src/shared/write_file_atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiCH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,cAAwB,GACjC,IAAI,CAiBN;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,cAAwB,GACjC,OAAO,CAAC,IAAI,CAAC,CAiBf"}
+{"version":3,"file":"write_file_atomic.d.ts","sourceRoot":"","sources":["../../src/shared/write_file_atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiCH;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,cAAwB,GACjC,IAAI,CAiBN;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,cAAwB,GACjC,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/shared/write_file_atomic.js

@@ -45,6 +45,12 @@ function assertPathNotDenied(filePath, projectPath) {
 /**
  * 同步原子写入：先写 .tmp 再 rename。
  *
+ * **并发安全范围**（适用所有 atomicWriteFile* 调用方，含 *_store.ts）：
+ * - 进程内原子（read 看不到半写文件，单线程运行时串行）
+ * - **跨进程不安全**：两进程 read-modify-rename 同文件，后者覆盖前者且无异常（[[init_must_not_parallel]] 根害）
+ * - 随机 tmp 后缀只防 tmp 碰撞，不序列化最终 rename
+ * 跨进程共享文件（init 全局 patterns / 2 个 MCP 服务器同项目）须外部串行。
+ *
  * @param filePath - 目标文件路径
  * @param content - 要写入的内容
  * @param encoding - 编码，默认 "utf-8"
@@ -55,7 +61,7 @@ export function atomicWriteFileSync(filePath, content, encoding = "utf-8") {
     // 确保父目录存在
     const dir = path.dirname(filePath);
     fs.mkdirSync(dir, { recursive: true });
-    // 使用随机 ID 后缀避免并发写入冲突
+    // 随机 tmp 后缀只防 tmp 碰撞（两进程同时写不互踩 tmp）；最终 rename 不序列化——跨进程 read-modify-rename 同文件仍会后者覆盖前者（见 JSDoc，[init_must_not_parallel] 根害）
     const tmpPath = `${filePath}.${crypto.randomUUID().slice(0, 8)}.tmp`;
     try {
         fs.writeFileSync(tmpPath, content, encoding);
@@ -83,7 +89,7 @@ export async function atomicWriteFile(filePath, content, encoding = "utf-8") {
     // 确保父目录存在
     const dir = path.dirname(filePath);
     await fsp.mkdir(dir, { recursive: true });
-    // 使用随机 ID 后缀避免并发写入冲突
+    // 随机 tmp 后缀只防 tmp 碰撞（两进程同时写不互踩 tmp）；最终 rename 不序列化——跨进程 read-modify-rename 同文件仍会后者覆盖前者（见 JSDoc，[init_must_not_parallel] 根害）
     const tmpPath = `${filePath}.${crypto.randomUUID().slice(0, 8)}.tmp`;
     try {
         await fsp.writeFile(tmpPath, content, encoding);

package/dist/shared/write_file_atomic.js.map

@@ -1 +1 @@
-{"version":3,"file":"write_file_atomic.js","sourceRoot":"","sources":["../../src/shared/write_file_atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,GAAG,MAAM,kBAAkB,CAAC;AACnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,QAAgB,EAAE,WAAoB;IACjE,MAAM,IAAI,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,IAAI,YAAoB,CAAC;IACzB,IAAI,CAAC;QACH,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,wBAAwB;IAClC,CAAC;IACD,mCAAmC;IACnC,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO;IAC1C,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IAC7C,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,KAAK,QAAQ,GAAG,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,OAAe,EACf,WAA2B,OAAO;IAElC,yBAAyB;IACzB,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9B,UAAU;IACV,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,qBAAqB;IACrB,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IACrE,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7C,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,qBAAqB;QACrB,IAAI,CAAC;YAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACxC,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAAe,EACf,WAA2B,OAAO;IAElC,yBAAyB;IACzB,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9B,UAAU;IACV,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,qBAAqB;IACrB,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IACrE,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,qBAAqB;QACrB,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}
+{"version":3,"file":"write_file_atomic.js","sourceRoot":"","sources":["../../src/shared/write_file_atomic.ts"],"names":[],"mappings":"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"}