@accelerator-mzq/forge 1.4.0

package/dist/core/archive/process-evidence-rerun.js

@@ -0,0 +1,238 @@
+// src/core/archive/process-evidence-rerun.ts — plan-9g Task 6.1
+// process_evidence fence worktree 重跑类不变量(5-6 / 13)
+// brainstorm spec §3 不变量表 + §7 mode 分支
+//
+// mode 分支(brainstorm spec §9.10):
+//   - full     → 全 task 重跑(并发 ≤ max_parallel_reruns)
+//   - sample   → 按 sample_ratio 抽样 task
+//   - hash-only → 跳过 worktree 重跑(返空数组;hash 校验已在 runFieldFence 9 完成)
+//
+// WARNING 13(timeout 在 sample/hash-only)由 ack-mode 隐含覆盖,本 fence 仅 stderr 不阻断
+//   (brainstorm spec §3 WARNING 流转 + v9 简化)
+//
+// Observation(latent bug 自修):
+//   - plan §7.1 line 4845/4914 用 execFileSync('sh', ['-c', testCommand]) — Windows 无 sh
+//     → 改为 execFileSync(testCommand, [], { shell: true })(Node 自适应 POSIX/Windows)
+//   - plan §7.1 line 4850/4853 chain.red_commit!.runner_report_path 在 async closure 内
+//     narrowing 会丢失(TS Object is possibly 'null')
+//     → 在 if (chain.red_commit) 后 const redCommit = chain.red_commit 解构,closure 用 redCommit
+import { execFileSync } from 'node:child_process';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { runInWorktree, ParallelGate, WorktreeError } from '../worktree.js';
+import { parseReporter } from '../test-reporters/index.js';
+import { seededSample } from './process-evidence-fence.js';
+/**
+ * runRerunFence — 跑 worktree 重跑类不变量 5/6/13
+ *
+ * @param ctx fence ctx(brainstorm spec §7.2)
+ * @returns ProcessEvidenceFinding[]
+ */
+export async function runRerunFence(ctx) {
+    const findings = [];
+    if (!ctx.processEvidence)
+        return findings;
+    const mode = ctx.processEvidence.process_verification_mode;
+    // hash-only:跳过 worktree 重跑(沿 brainstorm spec §9.10;hash 校验由 runFieldFence 9 完成)
+    if (mode === 'hash-only') {
+        return findings;
+    }
+    // 读 ForgeConfig.process_verification 配置
+    const config = {
+        sample_ratio: ctx.config.sample_ratio,
+        // 秒 → 毫秒(worktree timeout 用)
+        test_timeout_per_task: ctx.config.test_timeout_per_task * 1000,
+        max_parallel_reruns: ctx.config.max_parallel_reruns,
+    };
+    // 选择要重跑的 task 列表(full → 全;sample → 抽样)
+    const chains = ctx.processEvidence.tdd_event_chain;
+    let targetChains;
+    if (mode === 'full') {
+        targetChains = chains;
+    }
+    else {
+        // sample 抽样:按 sample_ratio,deterministic seed=changeId 保 fence reproducible
+        const sampleCount = Math.max(1, Math.ceil(chains.length * config.sample_ratio));
+        targetChains = seededSample(chains, sampleCount, ctx.changeId);
+    }
+    // 取 reporter 类型 + test command
+    const reporterType = ctx.testConfig.reporter;
+    const testCommand = ctx.testConfig.test_command;
+    // 创建并发 gate
+    const gate = new ParallelGate(config.max_parallel_reruns);
+    // 并发跑每个 chain(限 max_parallel_reruns)
+    const tasks = targetChains.map(async (chain) => {
+        await gate.acquire();
+        try {
+            // 不变量 5:RED worktree 重跑实际 fail + expected_failures 命中
+            if (chain.red_commit) {
+                // 修(latent bug 3):在 if (chain.red_commit) guard 后赋 const,
+                // 避免 async closure 内 TypeScript narrowing 丢失导致 Object is possibly 'null'
+                const redCommit = chain.red_commit;
+                try {
+                    const rerunResult = await runInWorktree(redCommit.sha, async (workPath) => {
+                        try {
+                            // 修(latent bug 1):shell:true 替代 execFileSync('sh',['-c',…])
+                            // Node 在 POSIX 用 /bin/sh,Windows 用 cmd.exe — 跨平台兼容
+                            execFileSync(testCommand, [], {
+                                cwd: workPath,
+                                shell: true,
+                                encoding: 'utf8',
+                                stdio: ['ignore', 'pipe', 'pipe'],
+                            });
+                            return {
+                                exitCode: 0,
+                                reportPath: join(workPath, redCommit.runner_report_path),
+                            };
+                        }
+                        catch {
+                            // 测试 fail 是预期(RED);取 exit_code 1
+                            return {
+                                exitCode: 1,
+                                reportPath: join(workPath, redCommit.runner_report_path),
+                            };
+                        }
+                    }, { cwd: ctx.cwd, timeout: config.test_timeout_per_task });
+                    // 不变量 5 子项 a:exit_code != 0(预期 RED fail)
+                    if (rerunResult.exitCode === 0) {
+                        findings.push({
+                            invariant: 5,
+                            severity: 'CRITICAL',
+                            message: `RED rerun expected fail but exit_code=0 (red sha=${redCommit.sha})`,
+                            taskRef: chain.task_ref,
+                        });
+                    }
+                    // 不变量 5 子项 b:expected_failures 中至少一个真失败(reporter parse 校验)
+                    if (existsSync(rerunResult.reportPath)) {
+                        const report = await parseReporter(rerunResult.reportPath, reporterType);
+                        const actualFailures = report.tests.filter((t) => t.status === 'fail');
+                        for (const ef of redCommit.expected_failures) {
+                            const matched = actualFailures.some((af) => af.test_file === ef.test_file && af.test_name === ef.test_name);
+                            if (!matched) {
+                                findings.push({
+                                    invariant: 5,
+                                    severity: 'CRITICAL',
+                                    message: `RED rerun expected_failure not actually failed: ${ef.test_file}::${ef.test_name}`,
+                                    taskRef: chain.task_ref,
+                                });
+                            }
+                        }
+                    }
+                }
+                catch (e) {
+                    if (e instanceof WorktreeError && e.stage === 'timeout') {
+                        // 不变量 13:timeout 分级(full=CRITICAL / sample=WARNING)
+                        const severity = mode === 'full' ? 'CRITICAL' : 'WARNING';
+                        findings.push({
+                            invariant: 13,
+                            severity,
+                            message: `RED rerun timeout (>${config.test_timeout_per_task}ms) in ${mode} mode for task ${chain.task_ref}`,
+                            taskRef: chain.task_ref,
+                        });
+                    }
+                    else if (e instanceof WorktreeError) {
+                        findings.push({
+                            invariant: 5,
+                            severity: 'CRITICAL',
+                            message: `RED worktree error ${e.stage}: ${e.message}`,
+                            taskRef: chain.task_ref,
+                        });
+                    }
+                    else {
+                        // v8.1 final review fix:parseReporter 抛 Error(corrupted XML 等)不能静默吞
+                        // 攻击路径:attacker 提交 corrupted XML report → parseReporter throws → 之前被吞 → invariant 5 sub-b 跳过
+                        findings.push({
+                            invariant: 5,
+                            severity: 'CRITICAL',
+                            message: `RED reporter parse error: ${e instanceof Error ? e.message : String(e)}`,
+                            taskRef: chain.task_ref,
+                        });
+                    }
+                }
+            }
+            // 不变量 6:GREEN worktree 重跑实际 pass
+            try {
+                const rerunResult = await runInWorktree(chain.green_commit.sha, async (workPath) => {
+                    try {
+                        // 修(latent bug 1):shell:true 跨平台
+                        execFileSync(testCommand, [], {
+                            cwd: workPath,
+                            shell: true,
+                            encoding: 'utf8',
+                            stdio: ['ignore', 'pipe', 'pipe'],
+                        });
+                        return {
+                            exitCode: 0,
+                            reportPath: join(workPath, chain.green_commit.runner_report_path),
+                        };
+                    }
+                    catch {
+                        return {
+                            exitCode: 1,
+                            reportPath: join(workPath, chain.green_commit.runner_report_path),
+                        };
+                    }
+                }, { cwd: ctx.cwd, timeout: config.test_timeout_per_task });
+                if (rerunResult.exitCode !== 0) {
+                    findings.push({
+                        invariant: 6,
+                        severity: 'CRITICAL',
+                        message: `GREEN rerun expected pass but exit_code=${rerunResult.exitCode}`,
+                        taskRef: chain.task_ref,
+                    });
+                }
+                // 不变量 6 加固:reporter 显示 0 failures
+                if (existsSync(rerunResult.reportPath)) {
+                    const report = await parseReporter(rerunResult.reportPath, reporterType);
+                    if (report.failCount > 0) {
+                        findings.push({
+                            invariant: 6,
+                            severity: 'CRITICAL',
+                            message: `GREEN rerun reporter shows ${report.failCount} failures`,
+                            taskRef: chain.task_ref,
+                        });
+                    }
+                }
+            }
+            catch (e) {
+                if (e instanceof WorktreeError && e.stage === 'timeout') {
+                    // 不变量 13:GREEN timeout 同样分级
+                    const severity = mode === 'full' ? 'CRITICAL' : 'WARNING';
+                    findings.push({
+                        invariant: 13,
+                        severity,
+                        message: `GREEN rerun timeout in ${mode} mode for ${chain.task_ref}`,
+                        taskRef: chain.task_ref,
+                    });
+                }
+                else if (e instanceof WorktreeError) {
+                    findings.push({
+                        invariant: 6,
+                        severity: 'CRITICAL',
+                        message: `GREEN worktree error ${e.stage}: ${e.message}`,
+                        taskRef: chain.task_ref,
+                    });
+                }
+                else {
+                    // v8.1 final review fix:parseReporter 抛 Error(corrupted XML 等)不能静默吞
+                    // 攻击路径:attacker 提交 corrupted XML report → parseReporter throws → 之前被吞 → invariant 6 sub-b 跳过
+                    findings.push({
+                        invariant: 6,
+                        severity: 'CRITICAL',
+                        message: `GREEN reporter parse error: ${e instanceof Error ? e.message : String(e)}`,
+                        taskRef: chain.task_ref,
+                    });
+                }
+            }
+        }
+        finally {
+            gate.release();
+        }
+    });
+    await Promise.all(tasks);
+    // 注:rerun-time WARNING(不变量 13 在 sample/hash-only)走 stderr 不阻断,不进 fence.ok=false
+    //     (brainstorm spec §3 v9 修订 — ack-mode 隐含覆盖);此处 findings 直接 caller 输出
+    //     CRITICAL 走 archive 拒签;WARNING 由 archive.ts process.stderr 输出告警
+    return findings;
+}
+//# sourceMappingURL=process-evidence-rerun.js.map

package/dist/core/archive/process-evidence-rerun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-evidence-rerun.js","sourceRoot":"","sources":["../../../src/core/archive/process-evidence-rerun.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,mDAAmD;AACnD,uCAAuC;AACvC,EAAE;AACF,kCAAkC;AAClC,qDAAqD;AACrD,wCAAwC;AACxC,oEAAoE;AACpE,EAAE;AACF,6EAA6E;AAC7E,4CAA4C;AAC5C,EAAE;AACF,8BAA8B;AAC9B,wFAAwF;AACxF,kFAAkF;AAClF,sFAAsF;AACtF,kDAAkD;AAClD,4FAA4F;AAE5F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAqB,MAAM,4BAA4B,CAAC;AAK9E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAgC;IAEhC,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAE9C,IAAI,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO,QAAQ,CAAC;IAE1C,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,CAAC,yBAAyB,CAAC;IAE3D,gFAAgF;IAChF,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,wCAAwC;IACxC,MAAM,MAAM,GAAG;QACb,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,YAAY;QACrC,6BAA6B;QAC7B,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,qBAAqB,GAAG,IAAI;QAC9D,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,mBAAmB;KACpD,CAAC;IAEF,uCAAuC;IACvC,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC,eAAe,CAAC;IACnD,IAAI,YAA6B,CAAC;IAClC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,YAAY,GAAG,MAAM,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,4EAA4E;QAC5E,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;QAChF,YAAY,GAAG,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,+BAA+B;IAC/B,MAAM,YAAY,GAAiB,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;IAC3D,MAAM,WAAW,GAAG,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC;IAEhD,YAAY;IACZ,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE1D,qCAAqC;IACrC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7C,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,sDAAsD;YACtD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,0DAA0D;gBAC1D,yEAAyE;gBACzE,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC;gBAEnC,IAAI,CAAC;oBACH,MAAM,WAAW,GAAG,MAAM,aAAa,CACrC,SAAS,CAAC,GAAG,EACb,KAAK,EAAE,QAAQ,EAAE,EAAE;wBACjB,IAAI,CAAC;4BACH,4DAA4D;4BAC5D,mDAAmD;4BACnD,YAAY,CAAC,WAAW,EAAE,EAAE,EAAE;gCAC5B,GAAG,EAAE,QAAQ;gCACb,KAAK,EAAE,IAAI;gCACX,QAAQ,EAAE,MAAM;gCAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;6BAClC,CAAC,CAAC;4BACH,OAAO;gCACL,QAAQ,EAAE,CAAC;gCACX,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,kBAAkB,CAAC;6BACzD,CAAC;wBACJ,CAAC;wBAAC,MAAM,CAAC;4BACP,iCAAiC;4BACjC,OAAO;gCACL,QAAQ,EAAE,CAAC;gCACX,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,kBAAkB,CAAC;6BACzD,CAAC;wBACJ,CAAC;oBACH,CAAC,EACD,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,qBAAqB,EAAE,CACxD,CAAC;oBAEF,yCAAyC;oBACzC,IAAI,WAAW,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;wBAC/B,QAAQ,CAAC,IAAI,CAAC;4BACZ,SAAS,EAAE,CAAC;4BACZ,QAAQ,EAAE,UAAU;4BACpB,OAAO,EAAE,oDAAoD,SAAS,CAAC,GAAG,GAAG;4BAC7E,OAAO,EAAE,KAAK,CAAC,QAAQ;yBACxB,CAAC,CAAC;oBACL,CAAC;oBAED,2DAA2D;oBAC3D,IAAI,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;wBACvC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;wBACzE,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;wBACvE,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,iBAAiB,EAAE,CAAC;4BAC7C,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CACjC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,CACvE,CAAC;4BACF,IAAI,CAAC,OAAO,EAAE,CAAC;gCACb,QAAQ,CAAC,IAAI,CAAC;oCACZ,SAAS,EAAE,CAAC;oCACZ,QAAQ,EAAE,UAAU;oCACpB,OAAO,EAAE,mDAAmD,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,EAAE;oCAC3F,OAAO,EAAE,KAAK,CAAC,QAAQ;iCACxB,CAAC,CAAC;4BACL,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,IAAI,CAAC,YAAY,aAAa,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;wBACxD,oDAAoD;wBACpD,MAAM,QAAQ,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;wBAC1D,QAAQ,CAAC,IAAI,CAAC;4BACZ,SAAS,EAAE,EAAE;4BACb,QAAQ;4BACR,OAAO,EAAE,uBAAuB,MAAM,CAAC,qBAAqB,UAAU,IAAI,kBAAkB,KAAK,CAAC,QAAQ,EAAE;4BAC5G,OAAO,EAAE,KAAK,CAAC,QAAQ;yBACxB,CAAC,CAAC;oBACL,CAAC;yBAAM,IAAI,CAAC,YAAY,aAAa,EAAE,CAAC;wBACtC,QAAQ,CAAC,IAAI,CAAC;4BACZ,SAAS,EAAE,CAAC;4BACZ,QAAQ,EAAE,UAAU;4BACpB,OAAO,EAAE,sBAAsB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE;4BACtD,OAAO,EAAE,KAAK,CAAC,QAAQ;yBACxB,CAAC,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACN,oEAAoE;wBACpE,6FAA6F;wBAC7F,QAAQ,CAAC,IAAI,CAAC;4BACZ,SAAS,EAAE,CAAC;4BACZ,QAAQ,EAAE,UAAU;4BACpB,OAAO,EAAE,6BAA6B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;4BAClF,OAAO,EAAE,KAAK,CAAC,QAAQ;yBACxB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAED,iCAAiC;YACjC,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,MAAM,aAAa,CACrC,KAAK,CAAC,YAAY,CAAC,GAAG,EACtB,KAAK,EAAE,QAAQ,EAAE,EAAE;oBACjB,IAAI,CAAC;wBACH,iCAAiC;wBACjC,YAAY,CAAC,WAAW,EAAE,EAAE,EAAE;4BAC5B,GAAG,EAAE,QAAQ;4BACb,KAAK,EAAE,IAAI;4BACX,QAAQ,EAAE,MAAM;4BAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;yBAClC,CAAC,CAAC;wBACH,OAAO;4BACL,QAAQ,EAAE,CAAC;4BACX,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC;yBAClE,CAAC;oBACJ,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO;4BACL,QAAQ,EAAE,CAAC;4BACX,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC;yBAClE,CAAC;oBACJ,CAAC;gBACH,CAAC,EACD,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,qBAAqB,EAAE,CACxD,CAAC;gBAEF,IAAI,WAAW,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBAC/B,QAAQ,CAAC,IAAI,CAAC;wBACZ,SAAS,EAAE,CAAC;wBACZ,QAAQ,EAAE,UAAU;wBACpB,OAAO,EAAE,2CAA2C,WAAW,CAAC,QAAQ,EAAE;wBAC1E,OAAO,EAAE,KAAK,CAAC,QAAQ;qBACxB,CAAC,CAAC;gBACL,CAAC;gBAED,kCAAkC;gBAClC,IAAI,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;oBACvC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;oBACzE,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;wBACzB,QAAQ,CAAC,IAAI,CAAC;4BACZ,SAAS,EAAE,CAAC;4BACZ,QAAQ,EAAE,UAAU;4BACpB,OAAO,EAAE,8BAA8B,MAAM,CAAC,SAAS,WAAW;4BAClE,OAAO,EAAE,KAAK,CAAC,QAAQ;yBACxB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,YAAY,aAAa,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxD,4BAA4B;oBAC5B,MAAM,QAAQ,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC1D,QAAQ,CAAC,IAAI,CAAC;wBACZ,SAAS,EAAE,EAAE;wBACb,QAAQ;wBACR,OAAO,EAAE,0BAA0B,IAAI,aAAa,KAAK,CAAC,QAAQ,EAAE;wBACpE,OAAO,EAAE,KAAK,CAAC,QAAQ;qBACxB,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,CAAC,YAAY,aAAa,EAAE,CAAC;oBACtC,QAAQ,CAAC,IAAI,CAAC;wBACZ,SAAS,EAAE,CAAC;wBACZ,QAAQ,EAAE,UAAU;wBACpB,OAAO,EAAE,wBAAwB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE;wBACxD,OAAO,EAAE,KAAK,CAAC,QAAQ;qBACxB,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,oEAAoE;oBACpE,6FAA6F;oBAC7F,QAAQ,CAAC,IAAI,CAAC;wBACZ,SAAS,EAAE,CAAC;wBACZ,QAAQ,EAAE,UAAU;wBACpB,OAAO,EAAE,+BAA+B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;wBACpF,OAAO,EAAE,KAAK,CAAC,QAAQ;qBACxB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEzB,gFAAgF;IAChF,0EAA0E;IAC1E,qEAAqE;IACrE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/core/archive/recover-prompt.d.ts

@@ -0,0 +1,10 @@
+/** 用户对 case C 的选择 */
+export type RecoverChoice = 'complete-archive' | 'undo-archive';
+/**
+ * 提示用户在 case C 状态下二选一。
+ *
+ * 默认实现:用 node:readline 从 stdin 读取数字 1/2,直到输入合法。
+ * 测试可注入自定义实现(例如直接返回固定值)。
+ */
+export declare function promptRecoverChoice(customPrompt?: () => Promise<RecoverChoice>): Promise<RecoverChoice>;
+//# sourceMappingURL=recover-prompt.d.ts.map

package/dist/core/archive/recover-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover-prompt.d.ts","sourceRoot":"","sources":["../../../src/core/archive/recover-prompt.ts"],"names":[],"mappings":"AAMA,qBAAqB;AACrB,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAEhE;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,GAC1C,OAAO,CAAC,aAAa,CAAC,CAgBxB"}

package/dist/core/archive/recover-prompt.js

@@ -0,0 +1,29 @@
+// case C 交互式二选一 prompt — Plan 6
+// 用 node:readline 封装,导出可注入函数便于测试 mock
+import { createInterface } from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+/**
+ * 提示用户在 case C 状态下二选一。
+ *
+ * 默认实现:用 node:readline 从 stdin 读取数字 1/2,直到输入合法。
+ * 测试可注入自定义实现(例如直接返回固定值)。
+ */
+export async function promptRecoverChoice(customPrompt) {
+    if (customPrompt)
+        return customPrompt();
+    const rl = createInterface({ input, output });
+    try {
+        while (true) {
+            const answer = (await rl.question('请输入 [1] 完成归档(重跑 Sync) 或 [2] 撤销归档(从 backup 还原):')).trim();
+            if (answer === '1')
+                return 'complete-archive';
+            if (answer === '2')
+                return 'undo-archive';
+            console.log('无效输入,请输入 1 或 2');
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=recover-prompt.js.map

package/dist/core/archive/recover-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover-prompt.js","sourceRoot":"","sources":["../../../src/core/archive/recover-prompt.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,IAAI,KAAK,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,cAAc,CAAC;AAKhE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,YAA2C;IAE3C,IAAI,YAAY;QAAE,OAAO,YAAY,EAAE,CAAC;IAExC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,CACb,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC,CACpE,CAAC,IAAI,EAAE,CAAC;YACT,IAAI,MAAM,KAAK,GAAG;gBAAE,OAAO,kBAAkB,CAAC;YAC9C,IAAI,MAAM,KAAK,GAAG;gBAAE,OAAO,cAAc,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/core/archive/recover.d.ts

@@ -0,0 +1,83 @@
+import type { SpecDelta } from '../specs-sync/index.js';
+/** recover 返回结果 */
+export interface RecoverResult {
+    /** 状态机判定的 case */
+    case: 'clean' | 'A' | 'B' | 'C' | 'corrupt';
+    /** 人类可读说明(含操作指引) */
+    message: string;
+    /**
+     * case='C' 时填充,提供 CLI 进行交互式二选一所需上下文。
+     * 其他 case 为 undefined。
+     */
+    caseCData?: {
+        /** archive change 目录绝对路径(用于"撤销归档"反向 rename) */
+        archiveChangeDir: string;
+        /** 原 change 名(去掉日期前缀,用于"撤销归档"反向 rename 目标) */
+        changeOrigId: string;
+        /** backup 目录绝对路径 */
+        backupDir: string;
+        /** archive specs 目录(用于"完成归档"重跑 Sync) */
+        archiveSpecsDir: string;
+        /** current specs 目录(用于"完成归档"或"撤销归档") */
+        currentSpecsDir: string;
+        /** 待应用 deltas(用于"完成归档") */
+        deltas: SpecDelta[];
+        /** backup 完整性 check 结果 */
+        backupIntegrity: BackupIntegrityResult;
+        /** archive 完整性 check 结果 */
+        archiveIntegrity: ArchiveIntegrityResult;
+    };
+}
+/**
+ * --recover 状态机(single-shot,spec §3.5)
+ *
+ * - case A:archive/<date>-<id>/ 存在 + backup 存在 + deltas 全是 replace + 内容一致(已应用)
+ *           → 仅删 backup（此路径实为 case B 的别名，保留兼容）
+ * - case B:archive/<date>-<id>/ 存在 + backup 残留 + deltas 全是 replace
+ *           且 archive specs 内容与 current specs 完全一致 → 已应用,只需删 backup
+ * - case C:archive/<date>-<id>/ 存在 + backup 残留 + deltas 含 create 或内容不一致
+ *           → specs 还没完全应用,状态不一致,报告需用户介入
+ * - clean:backup 不存在 → 无需恢复(含"archive 有历史但无半完成状态"的正常情况)
+ * - corrupt:backup 存在但 archive 不存在 → 状态损坏
+ *
+ * P2.1 修复:仅当 backupDir 存在时才考虑 halfArchivedChange,
+ *           否则一律 case='clean'(防止已完成 archive 被误判为半归档)。
+ * P2.2 修复:case B 删 backup 前要比对内容,不只看文件名(delta 全 replace 不够)。
+ *
+ * @param forgeRoot forge 根目录(如 forge/)绝对路径
+ */
+export declare function recover(forgeRoot: string): Promise<RecoverResult>;
+/** backup 完整性检查结果 */
+export interface BackupIntegrityResult {
+    ok: boolean;
+    reason?: string;
+}
+/**
+ * 检查 backup 目录完整性(Plan 6 — spec §3.5 case C 前置条件)。
+ *
+ * 完整性条件:
+ * 1. backup 目录可读
+ * 2. 目录非空(至少一个文件,否则代表 sync 没产生备份就死了)
+ * 3. 内含 .md 文件能被 utf8 读取(非二进制损坏)
+ *
+ * 若任一不满足 → ok=false + reason 描述哪条不满足
+ */
+export declare function checkBackupIntegrity(backupDir: string): Promise<BackupIntegrityResult>;
+/** archive 完整性检查结果 */
+export interface ArchiveIntegrityResult {
+    ok: boolean;
+    reason?: string;
+}
+/**
+ * 检查 archive/<date>-<id>/ 目录完整性(Plan 6 — spec §3.5 case C 前置条件)。
+ *
+ * 完整性条件:
+ * 1. 目录存在
+ * 2. 包含 specs/ 子目录(可空,但必须存在)
+ * 3. 包含 .verify-passed 与 .review-passed 两个 marker 文件
+ * 4. 两个 marker 都能被 utf8 读取(YAML 解析交给 archive 命令的 schema 校验)
+ *
+ * 若任一不满足 → ok=false + reason 描述
+ */
+export declare function checkArchiveIntegrity(archiveChangeDir: string): Promise<ArchiveIntegrityResult>;
+//# sourceMappingURL=recover.d.ts.map

package/dist/core/archive/recover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../../src/core/archive/recover.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,mBAAmB;AACnB,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,IAAI,EAAE,OAAO,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,SAAS,CAAC;IAC5C,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE;QACV,+CAA+C;QAC/C,gBAAgB,EAAE,MAAM,CAAC;QACzB,8CAA8C;QAC9C,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,wCAAwC;QACxC,eAAe,EAAE,MAAM,CAAC;QACxB,wCAAwC;QACxC,eAAe,EAAE,MAAM,CAAC;QACxB,2BAA2B;QAC3B,MAAM,EAAE,SAAS,EAAE,CAAC;QACpB,0BAA0B;QAC1B,eAAe,EAAE,qBAAqB,CAAC;QACvC,2BAA2B;QAC3B,gBAAgB,EAAE,sBAAsB,CAAC;KAC1C,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA2GvE;AA6BD,qBAAqB;AACrB,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA2B5F;AAED,sBAAsB;AACtB,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAsBjC"}

package/dist/core/archive/recover.js

@@ -0,0 +1,219 @@
+// archive --recover 状态机 — Plan 3 Task 13
+// spec §3.5:single-shot recover,失败抛 Error 让用户介入
+import { readdir, rm, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { applyDeltas, readDeltas } from '../specs-sync/index.js';
+/**
+ * --recover 状态机(single-shot,spec §3.5)
+ *
+ * - case A:archive/<date>-<id>/ 存在 + backup 存在 + deltas 全是 replace + 内容一致(已应用)
+ *           → 仅删 backup（此路径实为 case B 的别名，保留兼容）
+ * - case B:archive/<date>-<id>/ 存在 + backup 残留 + deltas 全是 replace
+ *           且 archive specs 内容与 current specs 完全一致 → 已应用,只需删 backup
+ * - case C:archive/<date>-<id>/ 存在 + backup 残留 + deltas 含 create 或内容不一致
+ *           → specs 还没完全应用,状态不一致,报告需用户介入
+ * - clean:backup 不存在 → 无需恢复(含"archive 有历史但无半完成状态"的正常情况)
+ * - corrupt:backup 存在但 archive 不存在 → 状态损坏
+ *
+ * P2.1 修复:仅当 backupDir 存在时才考虑 halfArchivedChange,
+ *           否则一律 case='clean'(防止已完成 archive 被误判为半归档)。
+ * P2.2 修复:case B 删 backup 前要比对内容,不只看文件名(delta 全 replace 不够)。
+ *
+ * @param forgeRoot forge 根目录(如 forge/)绝对路径
+ */
+export async function recover(forgeRoot) {
+    const cacheDir = join(forgeRoot, '.cache');
+    const archiveDir = join(forgeRoot, 'changes', 'archive');
+    const currentSpecsDir = join(forgeRoot, 'specs');
+    // 1. 扫描 .cache/ 找 archive-sync-backup-* 目录
+    let backupDir = null;
+    try {
+        const cacheEntries = await readdir(cacheDir);
+        // 找所有 backup 目录,取第一个(通常只有一个)
+        const backups = cacheEntries.filter((e) => e.startsWith('archive-sync-backup-'));
+        if (backups.length > 0) {
+            backupDir = join(cacheDir, backups[0]);
+        }
+    }
+    catch {
+        // .cache/ 目录不存在,忽略(backupDir 保持 null)
+    }
+    // P2.1 修复:只有 backup 存在才考虑半归档
+    // backup 不存在 → 一律 clean(防止多个历史 archive 被误判为半归档)
+    if (!backupDir) {
+        return { case: 'clean', message: '无半完成状态需要恢复' };
+    }
+    // 2. backup 存在 → 扫描 archive/ 目录,找最近的半归档 change
+    let halfArchivedChange = null;
+    if (existsSync(archiveDir)) {
+        try {
+            const archiveEntries = await readdir(archiveDir);
+            // 按字典序倒排,取最近的一个条目(日期前缀 YYYY-MM-DD-<id> 排序即时间序)
+            if (archiveEntries.length > 0) {
+                halfArchivedChange = archiveEntries.sort().reverse()[0] ?? null;
+            }
+        }
+        catch {
+            // archive 目录无法读取,忽略
+        }
+    }
+    // 3. 状态机判定
+    if (!halfArchivedChange) {
+        // corrupt:backup 存在但 archive 不存在
+        return {
+            case: 'corrupt',
+            message: 'corrupt:backup 存在但找不到对应的 archive 条目,状态损坏(退出码 4),需人工介入。\n' +
+                `  backup 位置:${backupDir}`,
+        };
+    }
+    // halfArchivedChange 存在 + backupDir 存在
+    const archiveSpecsDir = join(archiveDir, halfArchivedChange, 'specs');
+    const deltas = await readDeltas(archiveSpecsDir, currentSpecsDir);
+    if (deltas.every((d) => d.operation === 'replace')) {
+        // P2.2 修复:case B 判定不只看文件名,还要比对 archive spec 与 current spec 内容一致
+        const allMatch = await verifyAllReplacedAlreadyApplied(archiveSpecsDir, currentSpecsDir, deltas);
+        if (allMatch) {
+            // case B:specs 已应用,backup 是旧状态的残留,安全删除
+            await rm(backupDir, { recursive: true, force: true });
+            return {
+                case: 'B',
+                message: `case B:删除残留 backup 完成(${halfArchivedChange})`,
+            };
+        }
+    }
+    // case A:backup 存在,archive 存在,specs 未完全应用(deltas 含 create)
+    // 重跑 Sync(单次,失败抛 Error)
+    if (deltas.every((d) => d.operation !== 'delete')) {
+        await applyDeltas(currentSpecsDir, deltas);
+        await rm(backupDir, { recursive: true, force: true });
+        return {
+            case: 'A',
+            message: `case A:重跑 Sync 完成(${halfArchivedChange})`,
+        };
+    }
+    // case C:deltas 含 delete 或内容不一致(说明状态不一致)
+    // Plan 6:加完整性 check + 给 CLI 提供 caseCData 让其决定走交互(两者都完整)或退出 4(任一不完整)
+    const changeOrigId = halfArchivedChange.replace(/^\d{4}-\d{2}-\d{2}-/, '');
+    const archiveChangeDir = join(archiveDir, halfArchivedChange);
+    const backupIntegrity = await checkBackupIntegrity(backupDir);
+    const archiveIntegrity = await checkArchiveIntegrity(archiveChangeDir);
+    const baseMsg = `case C:archive/${halfArchivedChange} 与 backup 不一致(specs 应用状态)。\n` +
+        `  archive 位置:${archiveChangeDir}\n` +
+        `  backup 位置:${backupDir}`;
+    return {
+        case: 'C',
+        message: baseMsg,
+        caseCData: {
+            archiveChangeDir,
+            changeOrigId,
+            backupDir,
+            archiveSpecsDir,
+            currentSpecsDir,
+            deltas,
+            backupIntegrity,
+            archiveIntegrity,
+        },
+    };
+}
+/**
+ * P2.2 helper:验证所有 replace 操作的 archive spec 内容是否已应用到 current specs。
+ * 只有当每个 archive spec 文件内容与 current spec 完全一致时才返回 true。
+ */
+async function verifyAllReplacedAlreadyApplied(archiveSpecsDir, currentSpecsDir, deltas) {
+    for (const d of deltas) {
+        if (d.operation !== 'replace')
+            return false;
+        // SpecDelta.name 是不含 .md 的文件名
+        const archiveSpecPath = join(archiveSpecsDir, `${d.name}.md`);
+        const currentSpecPath = join(currentSpecsDir, `${d.name}.md`);
+        try {
+            const [archiveContent, currentContent] = await Promise.all([
+                readFile(archiveSpecPath, 'utf8'),
+                readFile(currentSpecPath, 'utf8'),
+            ]);
+            if (archiveContent !== currentContent)
+                return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * 检查 backup 目录完整性(Plan 6 — spec §3.5 case C 前置条件)。
+ *
+ * 完整性条件:
+ * 1. backup 目录可读
+ * 2. 目录非空(至少一个文件,否则代表 sync 没产生备份就死了)
+ * 3. 内含 .md 文件能被 utf8 读取(非二进制损坏)
+ *
+ * 若任一不满足 → ok=false + reason 描述哪条不满足
+ */
+export async function checkBackupIntegrity(backupDir) {
+    if (!existsSync(backupDir)) {
+        return { ok: false, reason: 'backup 目录不存在' };
+    }
+    let entries;
+    try {
+        entries = await readdir(backupDir);
+    }
+    catch (err) {
+        return { ok: false, reason: `backup 目录无法读取:${err.message}` };
+    }
+    if (entries.length === 0) {
+        return { ok: false, reason: 'backup 目录为空(预期至少一个备份文件)' };
+    }
+    // 抽查前 3 个 .md 文件能否 utf8 读取
+    const mdFiles = entries.filter((e) => e.endsWith('.md')).slice(0, 3);
+    // 防御:backup 必须含至少一个 .md 文件(否则 restoreSpecsFromBackup 会静默不还原)
+    if (mdFiles.length === 0) {
+        return { ok: false, reason: 'backup 目录不含 .md 文件(可能备份不完整)' };
+    }
+    for (const name of mdFiles) {
+        try {
+            await readFile(join(backupDir, name), 'utf8');
+        }
+        catch (err) {
+            return { ok: false, reason: `backup/${name} 无法读取:${err.message}` };
+        }
+    }
+    return { ok: true };
+}
+/**
+ * 检查 archive/<date>-<id>/ 目录完整性(Plan 6 — spec §3.5 case C 前置条件)。
+ *
+ * 完整性条件:
+ * 1. 目录存在
+ * 2. 包含 specs/ 子目录(可空,但必须存在)
+ * 3. 包含 .verify-passed 与 .review-passed 两个 marker 文件
+ * 4. 两个 marker 都能被 utf8 读取(YAML 解析交给 archive 命令的 schema 校验)
+ *
+ * 若任一不满足 → ok=false + reason 描述
+ */
+export async function checkArchiveIntegrity(archiveChangeDir) {
+    if (!existsSync(archiveChangeDir)) {
+        return { ok: false, reason: 'archive change 目录不存在' };
+    }
+    if (!existsSync(join(archiveChangeDir, 'specs'))) {
+        return { ok: false, reason: 'archive 内缺 specs/ 子目录' };
+    }
+    const verifyPath = join(archiveChangeDir, '.verify-passed');
+    const reviewPath = join(archiveChangeDir, '.review-passed');
+    if (!existsSync(verifyPath)) {
+        return { ok: false, reason: '.verify-passed marker 不存在' };
+    }
+    if (!existsSync(reviewPath)) {
+        return { ok: false, reason: '.review-passed marker 不存在' };
+    }
+    try {
+        await readFile(verifyPath, 'utf8');
+        await readFile(reviewPath, 'utf8');
+    }
+    catch (err) {
+        return { ok: false, reason: `marker 文件读取失败:${err.message}` };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=recover.js.map

package/dist/core/archive/recover.js.map

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

package/dist/core/archive/resume-summary.d.ts

@@ -0,0 +1,22 @@
+/** resume-summary 结果 — caller(archive 命令)根据 kind 决定 exit code */
+export type ResumeSummaryResult = {
+    kind: 'ok';
+    message: string;
+} | {
+    kind: 'conflict';
+    message: string;
+} | {
+    kind: 'missing';
+    message: string;
+} | {
+    kind: 'corrupt';
+    message: string;
+};
+/**
+ * 处理 archive 目录半完成状态的 .tmp summary
+ *
+ * @param forgeRoot <project>/forge/ 绝对路径
+ * @param archiveId archive 子目录名(`YYYY-MM-DD-<id>`)
+ */
+export declare function resumeArchiveSummary(forgeRoot: string, archiveId: string): Promise<ResumeSummaryResult>;
+//# sourceMappingURL=resume-summary.d.ts.map

package/dist/core/archive/resume-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-summary.d.ts","sourceRoot":"","sources":["../../../src/core/archive/resume-summary.ts"],"names":[],"mappings":"AAeA,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC,CA8D9B"}