@accelerator-mzq/forge 1.4.0

package/dist/core/archive/resume-summary.js

@@ -0,0 +1,82 @@
+// src/core/archive/resume-summary.ts — plan-9e1 Task 5(v2 BLOCKER 5)
+// forge archive --resume-summary <archive-id> 子流程实施
+// 五场景(v1 三场景 → v2 BLOCKER 5 +1 corrupt 路径 → Task 6 Minor 1 +1 already-done 路径):
+//   1. archive 目录有 .tmp 无正式 .yaml + .tmp 内容合法 → rename(ok)
+//   2. archive 目录有 .tmp 无正式 .yaml + .tmp 内容损坏 → 拒签(corrupt,沿 master §3.12.3 exit 3)
+//   3. 都存在 → 拒签(conflict,无法判断 ground truth)
+//   4. 无 .tmp 有正式 .yaml → ok(archive 已成功完成,无需 resume)— Task 6 Minor 1 修复
+//   5. 都不存在 → 报错(missing,状态损坏 / 无 summary 需要 resume)
+import { rename, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { validateArchiveSummarySchema } from '../validate/archive-summary-schema.js';
+/**
+ * 处理 archive 目录半完成状态的 .tmp summary
+ *
+ * @param forgeRoot <project>/forge/ 绝对路径
+ * @param archiveId archive 子目录名(`YYYY-MM-DD-<id>`)
+ */
+export async function resumeArchiveSummary(forgeRoot, archiveId) {
+    const archiveDir = join(forgeRoot, 'changes', 'archive', archiveId);
+    const tmpPath = join(archiveDir, 'archive_summary.tmp.yaml');
+    const finalPath = join(archiveDir, 'archive_summary.yaml');
+    const hasTmp = existsSync(tmpPath);
+    const hasFinal = existsSync(finalPath);
+    if (hasTmp && !hasFinal) {
+        // 场景 1/2:有 .tmp 无正式 .yaml → validate + rename
+        // v2 BLOCKER 5:rename 前 readFile + parseYaml + schema 校验
+        let parsed;
+        try {
+            const content = await readFile(tmpPath, 'utf8');
+            parsed = parseYaml(content);
+        }
+        catch (err) {
+            // Minor 3 修复:ENOENT 归 missing,其他归 corrupt
+            if (err.code === 'ENOENT') {
+                return {
+                    kind: 'missing',
+                    message: `✗ 找不到 archive_summary.tmp.yaml(${tmpPath});文件在 existsSync 后消失(race condition)`,
+                };
+            }
+            return {
+                kind: 'corrupt',
+                message: `✗ archive_summary.tmp.yaml YAML 解析失败(${tmpPath}):${err.message}`,
+            };
+        }
+        const schemaResult = validateArchiveSummarySchema(parsed, tmpPath);
+        if (!schemaResult.valid) {
+            const errMessages = schemaResult.errors.map((e) => `${e.field}: ${e.message}`).join('; ');
+            return {
+                kind: 'corrupt',
+                message: `✗ archive_summary.tmp.yaml schema 校验失败(${tmpPath}):${errMessages}`,
+            };
+        }
+        // 场景 1:校验通过 → 正常 rename
+        await rename(tmpPath, finalPath);
+        return {
+            kind: 'ok',
+            message: `✓ archive_summary.tmp.yaml → archive_summary.yaml (${archiveDir})`,
+        };
+    }
+    if (!hasTmp && hasFinal) {
+        // 场景 4(Task 6 Minor 1 修复):archive 已成功完成,无需 resume
+        return {
+            kind: 'ok',
+            message: `✓ archive_summary.yaml 已存在,无需 resume(${archiveDir})`,
+        };
+    }
+    if (hasTmp && hasFinal) {
+        // 场景 3:冲突,无法判断 ground truth
+        return {
+            kind: 'conflict',
+            message: `✗ 两个 archive_summary 都存在(${archiveDir}/archive_summary.{tmp.,}yaml),无法判断哪个是 ground truth — 用户需手动检查后删一个再重跑(沿 design §2.4.5 .tmp 生命周期表)`,
+        };
+    }
+    // 场景 5:都不存在
+    return {
+        kind: 'missing',
+        message: `✗ 找不到 archive_summary.{tmp.,}yaml(${archiveDir});该 archive 可能从未生成 summary(v0.4 老归档),或目录损坏`,
+    };
+}
+//# sourceMappingURL=resume-summary.js.map

package/dist/core/archive/resume-summary.js.map

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

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

@@ -0,0 +1,28 @@
+import type { ArchiveSummary } from '../schemas/archive-summary.js';
+import type { FenceCheckResult } from './fence.js';
+/** 选项:archive 时刻(测试可注入,生产用 new Date()) */
+export interface BuildArchiveSummaryOptions {
+    /** archived_at 时刻(沿 archive transaction 调用方计算,默认 new Date().toISOString()) */
+    archivedAt?: string;
+}
+/**
+ * 构造 archive_summary 对象
+ *
+ * @param verifyMarker .verify-passed 解析后对象(Record 形)
+ * @param reviewMarker .review-passed 解析后对象(Record 形)
+ * @param changeDir change 目录绝对路径(读 proposal.md / design.md 抽 scope-entries)
+ * @param changeId change id 字符串
+ * @param fenceResult plan-9g crossCuttingFenceCheck() 输出;9e2 接真实统计(替换 plan-9e1 placeholder)
+ * @param opts 可选项
+ */
+export declare function buildArchiveSummary(verifyMarker: Record<string, unknown>, reviewMarker: Record<string, unknown>, changeDir: string, changeId: string, fenceResult: FenceCheckResult, opts?: BuildArchiveSummaryOptions): Promise<ArchiveSummary>;
+/**
+ * v2 BLOCKER 4 修订:scope-entries YAML 完整性错误(parse 失败 / schema 非法 / anchor_id 不匹配)
+ * archive.ts 步骤 4.5 try/catch 转 fence business-fail exit 1
+ */
+export declare class ScopeEntriesIntegrityError extends Error {
+    readonly artifactName: string;
+    readonly anchorId: string;
+    constructor(message: string, artifactName: string, anchorId: string);
+}
+//# sourceMappingURL=summary-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary-builder.d.ts","sourceRoot":"","sources":["../../../src/core/archive/summary-builder.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,cAAc,EAKf,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAcnD,0CAA0C;AAC1C,MAAM,WAAW,0BAA0B;IACzC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,gBAAgB,EAC7B,IAAI,GAAE,0BAA+B,GACpC,OAAO,CAAC,cAAc,CAAC,CAkEzB;AAkFD;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;aAGjC,YAAY,EAAE,MAAM;aACpB,QAAQ,EAAE,MAAM;gBAFhC,OAAO,EAAE,MAAM,EACC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM;CAKnC"}

package/dist/core/archive/summary-builder.js

@@ -0,0 +1,287 @@
+// src/core/archive/summary-builder.ts — plan-9e1 Task 2
+// buildArchiveSummary:从 markers + change 目录构造 ArchiveSummary
+// 三 collector:
+//   collectAckedWarnings — verify_findings + review_outcomes 中 WARNING + resolved=false + 有 ack
+//   collectPendingSuggestions — verify_findings + review_outcomes 中 SUGGESTION + resolved=false
+//   collectHandoffEntries — 三类 input 聚合(verify/review SUGGESTION 持挂 + pause_decisions option=3 + scope-entries active)
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { ARCHIVE_SUMMARY_VERSION } from '../schemas/archive-summary.js';
+import { parseMarkdown } from '../parse/markdown.js';
+import { parseFencedYamlBlocks } from '../parse/fenced-yaml.js';
+import { SCOPE_ANCHOR_IDS } from '../schemas/scope-entries.js';
+/**
+ * 构造 archive_summary 对象
+ *
+ * @param verifyMarker .verify-passed 解析后对象(Record 形)
+ * @param reviewMarker .review-passed 解析后对象(Record 形)
+ * @param changeDir change 目录绝对路径(读 proposal.md / design.md 抽 scope-entries)
+ * @param changeId change id 字符串
+ * @param fenceResult plan-9g crossCuttingFenceCheck() 输出;9e2 接真实统计(替换 plan-9e1 placeholder)
+ * @param opts 可选项
+ */
+export async function buildArchiveSummary(verifyMarker, reviewMarker, changeDir, changeId, fenceResult, opts = {}) {
+    const archivedAt = opts.archivedAt ?? toIso8601(new Date());
+    const verifyFindings = Array.isArray(verifyMarker.verify_findings)
+        ? verifyMarker.verify_findings
+        : [];
+    const pauseDecisions = Array.isArray(verifyMarker.pause_decisions)
+        ? verifyMarker.pause_decisions
+        : [];
+    // review marker 也可能携带 pause_decisions(沿 9c superset additive 镜像)
+    const reviewPauseDecisions = Array.isArray(reviewMarker.pause_decisions)
+        ? reviewMarker.pause_decisions
+        : [];
+    const reviewOutcomes = Array.isArray(reviewMarker.review_outcomes)
+        ? reviewMarker.review_outcomes
+        : [];
+    const acked_warnings = collectAckedWarnings(verifyFindings, reviewOutcomes);
+    const pending_suggestions = collectPendingSuggestions(verifyFindings, reviewOutcomes);
+    // 合并 verify + review 的 pause_decisions(去重以 id 为 key,review 镜像优先级低)
+    const allPauseDecisions = mergePauseDecisions(pauseDecisions, reviewPauseDecisions);
+    const handoff_to_backlog = [
+        // 第 1 类:SUGGESTION 持挂(直接复用 pending_suggestions,但映射到 HandoffEntry 字段)
+        ...pending_suggestions.map((s) => ({
+            source: s.source,
+            id: s.id,
+            severity: 'SUGGESTION',
+            dimension: s.dimension,
+            check_type: s.check_type,
+            evidence: s.evidence,
+            recommendation: s.recommendation,
+        })),
+        // 第 2 类:pause_decisions chosen_option=3
+        ...allPauseDecisions
+            .filter((p) => p.chosen_option === 3)
+            .map((p) => ({
+            source: 'pause_decisions',
+            id: p.id,
+            severity: p.severity,
+            chosen_option: 3,
+            target_artifact: p.target_artifact,
+            target_anchor: p.target_anchor,
+            issue_summary: p.issue_summary,
+        })),
+        // 第 3 类:proposal/design scope-entries Out-of-Scope/Future-Work YAML 块的 active entry
+        ...(await collectScopeEntriesHandoff(changeDir)),
+    ];
+    return {
+        schema: 'forge-archive-summary/v1',
+        version: ARCHIVE_SUMMARY_VERSION,
+        archived_at: archivedAt,
+        change_id: changeId,
+        verify_passed: {
+            verified_invariants: buildVerifiedInvariants(verifyMarker),
+        },
+        review_passed: {
+            reviewers: [String(reviewMarker.reviewed_by ?? 'unknown')],
+        },
+        process_evidence_summary: buildProcessEvidenceSummary(fenceResult),
+        handoff_to_backlog,
+        acked_warnings,
+        pending_suggestions,
+    };
+}
+/** collector1:verify_findings WARNING + ack + review_outcomes WARNING 全名 + acked(v3 BLOCKER 4:resign 后或 v1.0 native 写入) */
+function collectAckedWarnings(findings, outcomes) {
+    const refs = [];
+    // verify_findings WARNING + ack(plan-9e1 v3 BLOCKER 3 已有,不动)
+    for (const f of findings) {
+        if (f.severity === 'WARNING' &&
+            f.resolved === false &&
+            f.severity_acked_by &&
+            f.severity_acked_at) {
+            refs.push({
+                source: 'verify_findings',
+                id: f.id,
+                dimension: f.dimension,
+                check_type: f.check_type,
+                evidence: f.evidence,
+                acked_by: f.severity_acked_by,
+                acked_at: f.severity_acked_at,
+            });
+        }
+    }
+    // review_outcomes WARNING 全名 + acked(v3 BLOCKER 4:resign 后或 v1.0 native 写入)
+    for (let i = 0; i < outcomes.length; i++) {
+        const o = outcomes[i];
+        // C 简码由 fence 拒签,不进 builder(沿 plan-9e1 v3 BLOCKER 3)
+        // S 简码 / CRITICAL 全名由 fence 拒签,不进 builder
+        // 仅 WARNING 全名 + accepted=true + rationale 非空(v0.4 review_outcomes 端的 "acked" 等价路径)
+        if (o.severity === 'WARNING' &&
+            o.resolved === false &&
+            o.accepted === true &&
+            typeof o.rationale === 'string' &&
+            o.rationale.length > 0) {
+            refs.push({
+                source: 'review_outcomes',
+                id: i,
+                acked_by: 'review-accepted',
+                acked_at: '', // review_outcomes 端无 user 字段,沿 plan-9e1 v1 collector1 review-accepted 标记
+                rationale: o.rationale,
+            });
+        }
+    }
+    return refs;
+}
+/** collector2:verify_findings + review_outcomes 中 SUGGESTION + resolved=false(v3 BLOCKER 4:L 简码 + SUGGESTION 全名双格式) */
+function collectPendingSuggestions(findings, outcomes) {
+    const refs = [];
+    // verify_findings SUGGESTION 全名(plan-9e1 v3 BLOCKER 3 已有,不动)
+    for (const f of findings) {
+        if (f.severity === 'SUGGESTION' && f.resolved === false) {
+            refs.push({
+                source: 'verify_findings',
+                id: f.id,
+                dimension: f.dimension,
+                check_type: f.check_type,
+                evidence: f.evidence,
+                recommendation: f.recommendation,
+            });
+        }
+    }
+    // review_outcomes L 简码 + SUGGESTION 全名双格式映射(v3 BLOCKER 4 新增)
+    for (let i = 0; i < outcomes.length; i++) {
+        const o = outcomes[i];
+        if ((o.severity === 'L' || o.severity === 'SUGGESTION') && o.resolved === false) {
+            refs.push({
+                source: 'review_outcomes',
+                id: i,
+                recommendation: o.rationale,
+            });
+        }
+    }
+    return refs;
+}
+/**
+ * v2 BLOCKER 4 修订:scope-entries YAML 完整性错误(parse 失败 / schema 非法 / anchor_id 不匹配)
+ * archive.ts 步骤 4.5 try/catch 转 fence business-fail exit 1
+ */
+export class ScopeEntriesIntegrityError extends Error {
+    artifactName;
+    anchorId;
+    constructor(message, artifactName, anchorId) {
+        super(message);
+        this.artifactName = artifactName;
+        this.anchorId = anchorId;
+        this.name = 'ScopeEntriesIntegrityError';
+    }
+}
+/**
+ * collector3 子函数:抽 proposal.md + design.md 中 scope-entries active entry
+ * v2 BLOCKER 4:parse 失败 / schema 非法 → 抛 ScopeEntriesIntegrityError(不再静默 continue)
+ */
+async function collectScopeEntriesHandoff(changeDir) {
+    const entries = [];
+    for (const artifactName of ['proposal.md', 'design.md']) {
+        const artifactPath = join(changeDir, artifactName);
+        if (!existsSync(artifactPath))
+            continue;
+        const content = await readFile(artifactPath, 'utf8');
+        const md = parseMarkdown(content);
+        for (const sec of md.sections) {
+            if (!sec.anchor || !SCOPE_ANCHOR_IDS.includes(sec.anchor))
+                continue;
+            // 仅取 forge-oos / forge-future-work(non-goals 不是 handoff 目标;non-goal 是"反目标",不需 backlog 追踪)
+            const anchorId = sec.anchor;
+            if (anchorId !== 'forge-oos' && anchorId !== 'forge-future-work')
+                continue;
+            let yamlBlocks;
+            try {
+                yamlBlocks = parseFencedYamlBlocks(sec.body);
+            }
+            catch (err) {
+                // v2 BLOCKER 4:parse 失败 → 抛错(让 archive fence 拒签),不再静默跳过
+                throw new ScopeEntriesIntegrityError(`scope-entries YAML parse failed in ${artifactName} section ${anchorId}: ${err.message}`, artifactName, anchorId);
+            }
+            if (yamlBlocks.length === 0)
+                continue; // 段内无 YAML 块允许(空段沿 9b 通过)
+            const block = yamlBlocks[0];
+            if (block.schema !== 'forge-scope-entries/v1') {
+                throw new ScopeEntriesIntegrityError(`scope-entries schema 非 'forge-scope-entries/v1'(${artifactName} section ${anchorId},实际 ${JSON.stringify(block.schema)})`, artifactName, anchorId);
+            }
+            if (block.anchor_id !== anchorId) {
+                throw new ScopeEntriesIntegrityError(`scope-entries anchor_id 不匹配(${artifactName}:${anchorId} 段内 YAML 块 anchor_id=${JSON.stringify(block.anchor_id)})`, artifactName, anchorId);
+            }
+            if (!Array.isArray(block.entries)) {
+                throw new ScopeEntriesIntegrityError(`scope-entries entries 非数组(${artifactName} section ${anchorId})`, artifactName, anchorId);
+            }
+            for (const e of block.entries) {
+                if (!e || typeof e !== 'object')
+                    continue;
+                // 仅 status=active 进 handoff(inherited/superseded/completed/obsolete 不进)
+                if (e.status !== 'active')
+                    continue;
+                entries.push({
+                    source: 'scope_entries',
+                    id: e.id,
+                    severity: null,
+                    category: e.category,
+                    reason: e.reason,
+                    target_artifact: artifactName,
+                    target_anchor: anchorId === 'forge-oos' ? '## Out of Scope' : '## Future Work',
+                });
+            }
+        }
+    }
+    return entries;
+}
+/** 合并 verify + review 端 pause_decisions(以 id 为 key 去重,verify 优先) */
+function mergePauseDecisions(verifyPauses, reviewPauses) {
+    const byId = new Map();
+    for (const p of verifyPauses)
+        byId.set(p.id, p);
+    for (const p of reviewPauses) {
+        if (!byId.has(p.id))
+            byId.set(p.id, p);
+    }
+    return [...byId.values()];
+}
+/** 沿 design verified_invariants 至少含 hash-match + evidence-complete(9d 三维度 fence 已通过) */
+function buildVerifiedInvariants(verifyMarker) {
+    const list = ['hash-match', 'evidence-complete'];
+    // 9d 三维度 fence 已通过 — 若 verify_findings 字段存在(老 marker 缺则跳),加上 verify-findings-fence
+    if (Array.isArray(verifyMarker.verify_findings)) {
+        list.push('verify-findings-fence');
+    }
+    if (Array.isArray(verifyMarker.pause_decisions)) {
+        list.push('pause-decisions-fence');
+    }
+    return list;
+}
+/** Date → 'YYYY-MM-DDTHH:MM:SSZ'(沿 marker-schema.ts:20 ISO 8601 UTC 格式) */
+function toIso8601(d) {
+    return d.toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+/**
+ * buildProcessEvidenceSummary — fence 14 不变量统计折数为 ProcessEvidenceSummary
+ *
+ * plan-9e2 v2 codex 一轮 MAJOR 修订:4 字段计数
+ *
+ * 输出 4 计数:
+ *   - invariants_passed: status='pass' 的数(真过校验)
+ *   - invariants_with_warning: status='warning' 的数(WARNING 经 fail/legacy-skip 优先级筛选后保留)
+ *   - invariants_failed: status='fail' 的数(v1.0 永远 = 0;fence.ok=false 时 archive 已 exit 1 不进本路径)
+ *   - legacy_exempt: status='legacy-skip' 的数(沿 §3.4.4.1)
+ *
+ * 不变式:passed + warning + failed + exempt === FENCE_INVARIANT_NAMES.length
+ *
+ * 注:不在 builder 内 throw — 让 archive-summary-schema validator 单点把守不变式
+ *     (避免双源校验路径分歧;沿 brainstorm spec §4.2 决策 #1)
+ */
+function buildProcessEvidenceSummary(fenceResult) {
+    // 按 status 4 态分类统计
+    const passed = fenceResult.results.filter((r) => r.status === 'pass').length;
+    const warning = fenceResult.results.filter((r) => r.status === 'warning').length;
+    const failed = fenceResult.results.filter((r) => r.status === 'fail').length;
+    const exempt = fenceResult.results.filter((r) => r.status === 'legacy-skip').length;
+    return {
+        placeholder: false,
+        invariants_passed: passed,
+        invariants_with_warning: warning,
+        invariants_failed: failed,
+        legacy_exempt: exempt,
+    };
+}
+//# sourceMappingURL=summary-builder.js.map

package/dist/core/archive/summary-builder.js.map

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

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

@@ -0,0 +1,8 @@
+import type { ArchiveSummary } from '../schemas/archive-summary.js';
+/**
+ * 渲染 archive 完成后的用户输出字符串
+ * @param summary ArchiveSummary 对象
+ * @param archiveDirName archive 子目录名(如 '2026-05-12-add-oauth-refresh');用于 yaml 路径提示
+ */
+export declare function renderArchiveSummaryOutput(summary: ArchiveSummary, archiveDirName: string): string;
+//# sourceMappingURL=summary-render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary-render.d.ts","sourceRoot":"","sources":["../../../src/core/archive/summary-render.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAkC,MAAM,+BAA+B,CAAC;AAEpG;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,GACrB,MAAM,CA8CR"}

package/dist/core/archive/summary-render.js

@@ -0,0 +1,64 @@
+// src/core/archive/summary-render.ts — plan-9e1 Task 4
+// renderArchiveSummaryOutput:把 ArchiveSummary → 用户可读字符串(沿 design §2.4.4 模板)
+/**
+ * 渲染 archive 完成后的用户输出字符串
+ * @param summary ArchiveSummary 对象
+ * @param archiveDirName archive 子目录名(如 '2026-05-12-add-oauth-refresh');用于 yaml 路径提示
+ */
+export function renderArchiveSummaryOutput(summary, archiveDirName) {
+    const lines = [];
+    lines.push('## Archive Complete');
+    lines.push('');
+    lines.push(`**Change:** ${summary.change_id}`);
+    lines.push(`**Archived to:** forge/changes/archive/${archiveDirName}/`);
+    lines.push(`**Specs:** ✓ Synced`);
+    // process_evidence_summary placeholder 显式标注(9e2 接 9g 后换成真实统计)
+    if (summary.process_evidence_summary.placeholder) {
+        lines.push(`**Security:** [process_evidence:placeholder] ${summary.process_evidence_summary.note ?? ''}`);
+    }
+    else {
+        const p = summary.process_evidence_summary;
+        lines.push(`**Security:** [process_evidence:passed=${p.invariants_passed ?? 0}/failed=${p.invariants_failed ?? 0}/legacy=${p.legacy_exempt ?? 0}]`);
+    }
+    lines.push('');
+    // Acknowledged Warnings 段
+    if (summary.acked_warnings.length > 0) {
+        lines.push(`### Acknowledged Warnings (${summary.acked_warnings.length})`);
+        for (const a of summary.acked_warnings) {
+            lines.push(renderAckedWarning(a));
+        }
+        lines.push('');
+    }
+    // Pending Suggestions 段
+    if (summary.pending_suggestions.length > 0) {
+        lines.push(`### Pending Suggestions (${summary.pending_suggestions.length}) — recorded in archive_summary`);
+        for (const s of summary.pending_suggestions) {
+            lines.push(renderPendingSuggestion(s));
+        }
+        lines.push('');
+    }
+    // 提示
+    lines.push(`Review handoff details: cat forge/changes/archive/${archiveDirName}/archive_summary.yaml`);
+    lines.push(`Cross-change backlog: run \`forge backlog list\` (see forge/backlog/)`);
+    return lines.join('\n');
+}
+/** 渲染单条 AckedWarningRef */
+function renderAckedWarning(a) {
+    const tag = `[WARNING] ${a.source}#${a.id}`;
+    const dim = a.dimension && a.check_type ? ` (${a.dimension}/${a.check_type})` : '';
+    const head = `- ${tag}${dim}`;
+    const ev = a.evidence ? `\n  Evidence: ${a.evidence}` : '';
+    const acked = `\n  Acked by: ${a.acked_by}${a.acked_at ? ` at ${a.acked_at}` : ''}`;
+    const rat = a.rationale ? `\n  Rationale: ${a.rationale}` : '';
+    return `${head}${ev}${acked}${rat}`;
+}
+/** 渲染单条 SuggestionRef */
+function renderPendingSuggestion(s) {
+    const tag = `[SUGGESTION] ${s.source}#${s.id}`;
+    const dim = s.dimension && s.check_type ? ` (${s.dimension}/${s.check_type})` : '';
+    const head = `- ${tag}${dim}`;
+    const ev = s.evidence ? `\n  Source: ${s.evidence}` : '';
+    const rec = s.recommendation ? `\n  Recommendation: ${s.recommendation}` : '';
+    return `${head}${ev}${rec}`;
+}
+//# sourceMappingURL=summary-render.js.map

package/dist/core/archive/summary-render.js.map

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

package/dist/core/archive/three-level-fence.d.ts

@@ -0,0 +1,10 @@
+import { type ValidationResult } from '../validate/types.js';
+/**
+ * 三级业务行为 fence(v2 BLOCKER 3 + MINOR 1 重构)
+ * @param verifyMarker .verify-passed marker(Record 形)— 读 verify_findings 字段
+ * @param reviewMarker .review-passed marker(Record 形)— 读 review_outcomes 字段
+ * @param verifyFile 可选错误报告用 .verify-passed 路径
+ * @param reviewFile 可选错误报告用 .review-passed 路径
+ */
+export declare function validateThreeLevelFence(verifyMarker: Record<string, unknown>, reviewMarker: Record<string, unknown>, verifyFile?: string, reviewFile?: string): ValidationResult;
+//# sourceMappingURL=three-level-fence.d.ts.map

package/dist/core/archive/three-level-fence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-level-fence.d.ts","sourceRoot":"","sources":["../../../src/core/archive/three-level-fence.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,sBAAsB,CAAC;AAWnF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,gBAAgB,CAqFlB"}

package/dist/core/archive/three-level-fence.js

@@ -0,0 +1,93 @@
+// src/core/archive/three-level-fence.ts — plan-9e1 Task 4(v2 BLOCKER 3 + MINOR 1 重构)
+// 9e1 三级业务行为 fence:
+//
+// 设计定位(v2 MINOR 1 重构):
+//   - **verify_findings 端**:仅 CRITICAL sanity 兜底(9d verify-findings-fence step 3.6 已拦
+//     CRITICAL+resolved=false 与 WARNING+!ack;9e1 此处只保 CRITICAL 双重保险,WARNING/SUGGESTION
+//     由 9d 单源,不重复)
+//   - **review_outcomes 端**:核心 — 简码 S/C/L 三分支裁决(沿 design §2.4.2 表 + §2.3.5 简码迁移)
+//     - S(CRITICAL 简码)+ resolved=false → 拒签
+//     - C(clarification)+ resolved=false → 拒签 + **提示 `forge upgrade --resign-markers`**
+//       (沿 design §2.3.5 line 559:C 不自动映射,必须人工迁移)
+//     - L(SUGGESTION)+ resolved=false → 通过(handoff to backlog)
+//
+// 沿 verify-findings-fence.ts / pause-decisions-fence.ts 模块化模式
+// 与 verify-findings-fence 的区别:本 fence **不重算 finding_hash**(verify-findings-fence 已校验),
+//   只做"业务行为"裁决
+import { failed, mergeResults } from '../validate/types.js';
+/**
+ * 三级业务行为 fence(v2 BLOCKER 3 + MINOR 1 重构)
+ * @param verifyMarker .verify-passed marker(Record 形)— 读 verify_findings 字段
+ * @param reviewMarker .review-passed marker(Record 形)— 读 review_outcomes 字段
+ * @param verifyFile 可选错误报告用 .verify-passed 路径
+ * @param reviewFile 可选错误报告用 .review-passed 路径
+ */
+export function validateThreeLevelFence(verifyMarker, reviewMarker, verifyFile, reviewFile) {
+    const results = [];
+    // 1. verify_findings 端:**仅 CRITICAL sanity 兜底**(v2 MINOR 1:WARNING/SUGGESTION 由 9d 单源)
+    const findings = Array.isArray(verifyMarker.verify_findings)
+        ? verifyMarker.verify_findings
+        : [];
+    for (let i = 0; i < findings.length; i++) {
+        const f = findings[i];
+        if (f.severity === 'CRITICAL' && f.resolved === false) {
+            results.push(failed({
+                artifact: 'marker',
+                field: `verify_findings[${i}].resolved`,
+                message: `[9e1 sanity 兜底] CRITICAL finding 未 resolve;正常应被 9d verify-findings-fence step 3.6 拦截,此处兜底拒签(沿 design §2.4.2 CRITICAL 行)`,
+                file: verifyFile,
+            }));
+        }
+        // v2 MINOR 1:WARNING + resolved=false + !ack 由 9d verify-findings-fence step 3.6 拦,本 fence 不重复
+        // SUGGESTION + resolved=false 由 9e1 builder 进 pending_suggestions 持挂,本 fence 不拦
+    }
+    // 2. review_outcomes 端:**核心** — **v6 plan-9j 修订:simcode + 全名双格式裁决**
+    // 沿 summary-builder.ts:70-72 同 Array.isArray guard 模式(非 array 严格视为空数组,不接受 falsy 误读)
+    const outcomes = Array.isArray(reviewMarker.review_outcomes)
+        ? reviewMarker.review_outcomes
+        : [];
+    for (let i = 0; i < outcomes.length; i++) {
+        const o = outcomes[i];
+        const sev = o.severity;
+        const fieldBase = `review_outcomes[${i}]`;
+        // CRITICAL/S(同义)— 拒签
+        if ((sev === 'S' || sev === 'CRITICAL') && !o.resolved) {
+            results.push(failed({
+                artifact: 'marker',
+                field: `${fieldBase}.severity`,
+                message: `${sev}(${sev === 'S' ? 'CRITICAL 简码' : 'CRITICAL 全名'})未 resolve,archive 拒签(沿 design §2.4.2 + plan-9j v3 BLOCKER 4 双格式)`,
+                file: reviewFile,
+            }));
+            continue;
+        }
+        // C 简码 — 硬墙拒签(沿 plan-9e1 v4 BLOCKER 1)
+        if (sev === 'C') {
+            results.push(failed({
+                artifact: 'marker',
+                field: `${fieldBase}.severity`,
+                message: `review_outcomes C(clarification 简码,resolved=${String(o.resolved)})不允许 archive。\n` +
+                    `  必须等 plan-9j 完成跑 \`forge upgrade --resign-markers\` 迁移(沿 design §2.3.5)。\n` +
+                    `  9e1 fence 是硬墙 — 不接受手动编辑 marker(违反 AI 反向加固 + ReviewOutcome 接口不接受全名 + ack-log 协议)。`,
+                file: reviewFile,
+            }));
+            continue;
+        }
+        // WARNING 全名 — 必须 acked(简码 v0.4 无 WARNING 简码 — 仅 v1.0 全名;沿 design §2.3.5)
+        if (sev === 'WARNING' && !o.resolved) {
+            const acked = o.accepted === true && typeof o.rationale === 'string' && o.rationale.length > 0;
+            if (!acked) {
+                results.push(failed({
+                    artifact: 'marker',
+                    field: `${fieldBase}.accepted`,
+                    message: `review_outcomes WARNING(v1.0 全名)未 resolve + 缺 acked(需 accepted=true + rationale 非空)`,
+                    file: reviewFile,
+                }));
+            }
+            continue;
+        }
+        // L/SUGGESTION(同义)+ resolved=false → 通过(handoff to backlog)
+        // 全 resolved=true → 通过(无 fence 动作)
+    }
+    return mergeResults(...results);
+}
+//# sourceMappingURL=three-level-fence.js.map

package/dist/core/archive/three-level-fence.js.map

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