@accelerator-mzq/forge 1.4.0

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

@@ -0,0 +1,41 @@
+import type { ArchiveSummary } from '../schemas/archive-summary.js';
+/** archiveTransaction 输入参数 */
+export interface ArchiveTransactionInput {
+    /** <project>/forge/ 目录绝对路径 */
+    forgeRoot: string;
+    /** change id,如 'add-login' */
+    changeId: string;
+    /** 归档日期,格式 'YYYY-MM-DD',如 '2026-05-04' */
+    archiveDate: string;
+    /**
+     * plan-9e1 Task 3 新增:可选 archive_summary 对象
+     * - 传:Move 前在 source 写 archive_summary.tmp.yaml,Move 后 rename → archive_summary.yaml
+     * - 不传:沿 v0.4 老行为,不产 summary(向后兼容)
+     */
+    archiveSummary?: ArchiveSummary;
+}
+/**
+ * archive 顺序原子化:Move→Sync(spec §3.5)
+ *
+ * 阶段 0 — .tmp 写(plan-9e1 Task 3 新增,可选):
+ *   在 source 目录写 archive_summary.tmp.yaml,跟随 Move 一起搬到 archive 目录
+ *
+ * 阶段 1 — Move(原子):
+ *   fs.rename forge/changes/<id>/ → forge/changes/archive/<date>-<id>/
+ *
+ * 阶段 1.5 — rename .tmp → 正式名(plan-9e1 Task 3 新增,可选):
+ *   archive 目录内 archive_summary.tmp.yaml → archive_summary.yaml
+ *
+ * 阶段 1.6 — Backup(独立阶段,失败立即反向 rename + 不进 Sync)
+ *
+ * 阶段 2 — Sync(可回滚):
+ *   a. 备份当前 forge/specs/ → .cache/archive-sync-backup-<pid>/
+ *   b. readDeltas + applyDeltas
+ *   c. 成功 → 删 backup
+ *   d. 失败 → 从 backup 恢复 specs/ + 反向 rename archive 回 changes/<id>/
+ *
+ * crash/SIGKILL 由 OS fs.rename 原子性保证(best-effort)。
+ * --recover 由 Plan 3 Task 13 处理。
+ */
+export declare function archiveTransaction(input: ArchiveTransactionInput): Promise<void>;
+//# sourceMappingURL=transaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../../src/core/archive/transaction.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,8BAA8B;AAC9B,MAAM,WAAW,uBAAuB;IACtC,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgKtF"}

package/dist/core/archive/transaction.js

@@ -0,0 +1,184 @@
+// archive 顺序原子化:Move→Sync(spec §3.5)
+// Plan 3 Task 11:archive transaction 实现
+// plan-9e1 Task 3 修订:加 archive_summary `.tmp` 写入(Move 前)+ rename 到正式名(Move 后)+ 失败回滚
+import { rename, mkdir, rm, cp, writeFile, unlink } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { stringify as stringifyYaml } from 'yaml';
+import { readDeltas, applyDeltas } from '../specs-sync/index.js';
+/**
+ * archive 顺序原子化:Move→Sync(spec §3.5)
+ *
+ * 阶段 0 — .tmp 写(plan-9e1 Task 3 新增,可选):
+ *   在 source 目录写 archive_summary.tmp.yaml,跟随 Move 一起搬到 archive 目录
+ *
+ * 阶段 1 — Move(原子):
+ *   fs.rename forge/changes/<id>/ → forge/changes/archive/<date>-<id>/
+ *
+ * 阶段 1.5 — rename .tmp → 正式名(plan-9e1 Task 3 新增,可选):
+ *   archive 目录内 archive_summary.tmp.yaml → archive_summary.yaml
+ *
+ * 阶段 1.6 — Backup(独立阶段,失败立即反向 rename + 不进 Sync)
+ *
+ * 阶段 2 — Sync(可回滚):
+ *   a. 备份当前 forge/specs/ → .cache/archive-sync-backup-<pid>/
+ *   b. readDeltas + applyDeltas
+ *   c. 成功 → 删 backup
+ *   d. 失败 → 从 backup 恢复 specs/ + 反向 rename archive 回 changes/<id>/
+ *
+ * crash/SIGKILL 由 OS fs.rename 原子性保证(best-effort)。
+ * --recover 由 Plan 3 Task 13 处理。
+ */
+export async function archiveTransaction(input) {
+    const { forgeRoot, changeId, archiveDate, archiveSummary } = input;
+    // 路径计算
+    const sourceDir = join(forgeRoot, 'changes', changeId);
+    const archiveTargetDir = join(forgeRoot, 'changes', 'archive', `${archiveDate}-${changeId}`);
+    const currentSpecsDir = join(forgeRoot, 'specs');
+    const backupDir = join(forgeRoot, '.cache', `archive-sync-backup-${process.pid}`);
+    // plan-9e1 Task 3:archive_summary 路径(.tmp 与正式名)
+    const tmpSummaryInSource = join(sourceDir, 'archive_summary.tmp.yaml');
+    const tmpSummaryInArchive = join(archiveTargetDir, 'archive_summary.tmp.yaml');
+    const finalSummaryInArchive = join(archiveTargetDir, 'archive_summary.yaml');
+    // —— 阶段 0(plan-9e1 Task 3):Move 前在 source 写 archive_summary.tmp.yaml ——
+    // 沿 design §2.4.5 step 3:archive_summary.tmp.yaml 写到 source 目录,跟随 Move 一起搬到 archive 目录
+    // 失败处理:写入失败 → 抛错(整体 archive 失败,markers 未移走,source 仅 .tmp 残留 → finally 兜底 unlink)
+    if (archiveSummary) {
+        try {
+            const yamlText = stringifyYaml(archiveSummary);
+            await writeFile(tmpSummaryInSource, yamlText, 'utf8');
+        }
+        catch (writeErr) {
+            // .tmp 写失败 → source 可能残留 partial 文件 → unlink + 抛错(整体 archive 失败)
+            if (existsSync(tmpSummaryInSource)) {
+                await unlink(tmpSummaryInSource).catch(() => {
+                    /* unlink 失败也忽略,把原始 write 错误抛出 */
+                });
+            }
+            throw new Error(`archive_summary.tmp.yaml 写入失败: ${writeErr.message}`);
+        }
+    }
+    // —— 阶段 1:Move(单原子 fs.rename)——
+    // 确保 archive 父目录存在,但不创建目标目录本身(rename 负责)
+    await mkdir(dirname(archiveTargetDir), { recursive: true });
+    // 若目标已存在,rename 会失败(EEXIST/ENOTEMPTY),即 Move 失败路径
+    try {
+        await rename(sourceDir, archiveTargetDir);
+    }
+    catch (moveErr) {
+        // plan-9e1 Task 3:Move 失败 → source 残留 .tmp → unlink + 抛错
+        if (archiveSummary && existsSync(tmpSummaryInSource)) {
+            await unlink(tmpSummaryInSource).catch(() => {
+                /* 忽略 unlink 失败,把原始 move 错误抛出 */
+            });
+        }
+        throw moveErr;
+    }
+    // —— 阶段 1.5(plan-9e1 Task 3):Move 后 rename .tmp → 正式名 ——
+    // 沿 design §2.4.5 step 5:archive 目录内 archive_summary.tmp.yaml → archive_summary.yaml
+    // 失败处理:rename 失败极罕见(同目录 rename);此时 archive 目录已 move,数据已在 archive,
+    //   按 design §2.4.5 不强制回滚 Move,改提示用户走 forge archive --resume-summary <id>
+    let summaryRenamed = false;
+    if (archiveSummary) {
+        try {
+            await rename(tmpSummaryInArchive, finalSummaryInArchive);
+            summaryRenamed = true;
+        }
+        catch (renameErr) {
+            // 不回滚 Move(数据已在 archive),抛特殊错误供 caller 提示用户 --resume-summary
+            throw new Error(`archive_summary rename 失败(.tmp → 正式名);archive 已 move 完成但 summary 仍是 .tmp 名。\n` +
+                `请运行:forge archive --resume-summary ${archiveDate}-${changeId}\n` +
+                `原始错误:${renameErr.message}`);
+        }
+    }
+    // summaryRenamed 仅作后续可能扩展使用(当前阶段:已 rename 或无 summary)
+    void summaryRenamed;
+    // —— 阶段 1.6:Backup(独立阶段,失败立即反向 rename + 不进 Sync)——
+    // P2.2 修复:backup 独立成阶段,失败时 specs 不被破坏
+    let backupSucceeded = false;
+    try {
+        if (existsSync(currentSpecsDir)) {
+            await cp(currentSpecsDir, backupDir, { recursive: true });
+        }
+        backupSucceeded = true;
+    }
+    catch (backupErr) {
+        // 部分 backup 残留 → 清理
+        if (existsSync(backupDir)) {
+            await rm(backupDir, { recursive: true, force: true });
+        }
+        // 反向 rename:把已移走的 change 目录恢复(specs/ 未动)
+        try {
+            await rename(archiveTargetDir, sourceDir);
+            // v2 MAJOR 1 修订:反向 Move 后 unlink 任何 summary 文件(无论 .tmp / 正式名),
+            // 让回滚状态完全等价"事务开始前 — 无 summary 残留",重试 archive 时重新生成
+            if (archiveSummary) {
+                const finalInSource = join(sourceDir, 'archive_summary.yaml');
+                if (existsSync(finalInSource)) {
+                    await unlink(finalInSource).catch(() => {
+                        /* unlink 失败忽略 — backup 错是 root cause */
+                    });
+                }
+                if (existsSync(tmpSummaryInSource)) {
+                    await unlink(tmpSummaryInSource).catch(() => { });
+                }
+            }
+        }
+        catch {
+            // 反向 rename 失败也忽略,把原始 backup 错抛出去(用户能看到 specs/ 未变)
+        }
+        throw new Error(`Backup failed before sync: ${backupErr.message}`);
+    }
+    // —— 阶段 2:Sync(可回滚,只在 backup 成功时启用 backup 路径)——
+    try {
+        // 2a. 读 deltas + 应用
+        const archiveSpecsDir = join(archiveTargetDir, 'specs');
+        const deltas = await readDeltas(archiveSpecsDir, currentSpecsDir);
+        await applyDeltas(currentSpecsDir, deltas);
+        // 2b. 成功 → 清理 backup
+        if (existsSync(backupDir)) {
+            await rm(backupDir, { recursive: true, force: true });
+        }
+    }
+    catch (syncErr) {
+        // —— 回滚路径(P2.3 修复:用 rolledBack flag 防止 throw 被 inner catch 误捕获)——
+        let rolledBack = false;
+        try {
+            // a. 仅 backupSucceeded 时才从 backup 恢复 specs/
+            if (backupSucceeded && existsSync(backupDir)) {
+                // 清除(可能)已部分修改的 specs/
+                await rm(currentSpecsDir, { recursive: true, force: true });
+                await cp(backupDir, currentSpecsDir, { recursive: true });
+            }
+            // b. 反向 rename:archive/<date>-<id>/ 回 changes/<id>/
+            await rename(archiveTargetDir, sourceDir);
+            // v2 MAJOR 1 修订:反向 Move 后 unlink 任何 summary 文件(无论 .tmp / 正式名)
+            if (archiveSummary) {
+                const finalInSource = join(sourceDir, 'archive_summary.yaml');
+                if (existsSync(finalInSource)) {
+                    await unlink(finalInSource).catch(() => {
+                        /* unlink 失败忽略 — Sync 错是 root cause */
+                    });
+                }
+                if (existsSync(tmpSummaryInSource)) {
+                    await unlink(tmpSummaryInSource).catch(() => { });
+                }
+            }
+            // c. 清理 backup
+            if (existsSync(backupDir)) {
+                await rm(backupDir, { recursive: true, force: true });
+            }
+            rolledBack = true;
+        }
+        catch (rbErr) {
+            // 回滚本身也失败 — 人工介入
+            throw new Error(`Sync failed AND rollback failed: ${syncErr.message} / ${rbErr.message}\n` +
+                `请手动检查 ${backupDir} 和 ${archiveTargetDir}`);
+        }
+        // 回滚成功 → 在 inner try 外面 throw,避免被 inner catch 误捕获
+        if (rolledBack) {
+            throw new Error(`Sync failed and rolled back: ${syncErr.message}`);
+        }
+    }
+}
+//# sourceMappingURL=transaction.js.map

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

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

package/dist/core/archive/verify-findings-fence.d.ts

@@ -0,0 +1,11 @@
+import { type ValidationResult } from '../validate/types.js';
+/**
+ * verify_findings fence 校验(沿 design §2.2.4)
+ * - automated=true CRITICAL 不可降级:finding_hash 重算比对
+ * - CRITICAL + resolved=false → 拒签(无例外强 fence,无 ack 路径)
+ * - WARNING + resolved=false + 无 ack → 拒签
+ * - SUGGESTION 通过(允许带 finding archive)
+ * - downgrade 路径校验 downgrade_acked_by + downgrade_rationale 非空
+ */
+export declare function validateVerifyFindingsFence(verifyMarker: Record<string, unknown>, file?: string): ValidationResult;
+//# sourceMappingURL=verify-findings-fence.d.ts.map

package/dist/core/archive/verify-findings-fence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-findings-fence.d.ts","sourceRoot":"","sources":["../../../src/core/archive/verify-findings-fence.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,gBAAgB,EAA4B,MAAM,sBAAsB,CAAC;AAEvF;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,IAAI,CAAC,EAAE,MAAM,GACZ,gBAAgB,CA8ElB"}

package/dist/core/archive/verify-findings-fence.js

@@ -0,0 +1,80 @@
+// src/core/archive/verify-findings-fence.ts — plan-9d Task 6 (v2 模块化)
+// 沿 design §2.2.4 fence 三级矩阵:CRITICAL 无 ack 路径(自动/LLM 都拒签)/ WARNING 必须 ack /
+// SUGGESTION 通过;finding_hash 重算比对(篡改拒签);downgrade ack 校验
+import { extractHashPayload, computeFindingHash } from '../validate/finding-hash.js';
+import { ok, failed, mergeResults } from '../validate/types.js';
+/**
+ * verify_findings fence 校验(沿 design §2.2.4)
+ * - automated=true CRITICAL 不可降级:finding_hash 重算比对
+ * - CRITICAL + resolved=false → 拒签(无例外强 fence,无 ack 路径)
+ * - WARNING + resolved=false + 无 ack → 拒签
+ * - SUGGESTION 通过(允许带 finding archive)
+ * - downgrade 路径校验 downgrade_acked_by + downgrade_rationale 非空
+ */
+export function validateVerifyFindingsFence(verifyMarker, file) {
+    const findings = verifyMarker.verify_findings;
+    if (!Array.isArray(findings))
+        return ok(); // 无 verify_findings 字段(老 marker)→ 跳
+    const results = [];
+    for (let i = 0; i < findings.length; i++) {
+        const f = findings[i];
+        const fieldBase = `verify_findings[${i}]`;
+        // 1. finding_hash 重算比对(篡改任何字段都会让 hash 不一致)
+        const payload = extractHashPayload(f);
+        const expectedHash = computeFindingHash(payload);
+        if (f.finding_hash !== expectedHash) {
+            results.push(failed({
+                artifact: 'marker',
+                field: `${fieldBase}.finding_hash`,
+                message: `finding_hash mismatch: expected ${expectedHash.slice(0, 16)}..., got ${f.finding_hash.slice(0, 16)}...`,
+                file,
+            }));
+            continue; // hash 失败后不再校验其他规则(避免 cascade)
+        }
+        // 2. 三级 × resolved × ack 矩阵
+        if (f.severity === 'CRITICAL' && f.resolved === false) {
+            // CRITICAL 无例外强 fence(无 ack 路径,沿 design §2.2.4)
+            results.push(failed({
+                artifact: 'marker',
+                field: `${fieldBase}.resolved`,
+                message: f.automated
+                    ? `automated CRITICAL finding must be resolved (cannot ack-downgrade automated CRITICAL,沿 design §2.2.4)`
+                    : `CRITICAL finding must be resolved (no ack path for CRITICAL,沿 design §2.2.4)`,
+                file,
+            }));
+        }
+        else if (f.severity === 'WARNING' && f.resolved === false) {
+            // WARNING + 未 resolved → 必须 ack(severity_acked_by + severity_acked_at)
+            if (!f.severity_acked_by || !f.severity_acked_at) {
+                results.push(failed({
+                    artifact: 'marker',
+                    field: `${fieldBase}.severity_acked_by`,
+                    message: `WARNING + resolved=false 必须有 severity_acked_by + severity_acked_at(沿 design §2.2.4)`,
+                    file,
+                }));
+            }
+        }
+        // SUGGESTION + resolved=false → 通过(允许带 finding archive)
+        // 3. downgrade 路径(若 downgraded_from 非空)
+        if (f.downgraded_from) {
+            if (!f.downgrade_acked_by) {
+                results.push(failed({
+                    artifact: 'marker',
+                    field: `${fieldBase}.downgrade_acked_by`,
+                    message: `downgrade 路径必须有 downgrade_acked_by(沿 design §2.3.3 C)`,
+                    file,
+                }));
+            }
+            if (!f.downgrade_rationale) {
+                results.push(failed({
+                    artifact: 'marker',
+                    field: `${fieldBase}.downgrade_rationale`,
+                    message: `downgrade 路径必须有 downgrade_rationale(沿 design §2.3.3 C)`,
+                    file,
+                }));
+            }
+        }
+    }
+    return mergeResults(...results);
+}
+//# sourceMappingURL=verify-findings-fence.js.map

package/dist/core/archive/verify-findings-fence.js.map

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

package/dist/core/archive/version-retrograde-fence.d.ts

@@ -0,0 +1,10 @@
+import { type ValidationResult } from '../validate/types.js';
+/**
+ * 校验 marker 的 created_by_tool_version 字段不能从高版本回降低版本
+ *
+ * @param markerPath marker 文件绝对路径
+ * @param marker 解析后的 Record
+ * @param gitDir 可选,git 仓库根目录(用于 `git log`);非 git 项目 → 跳过 best-effort
+ */
+export declare function validateVersionRetrograde(markerPath: string, marker: Record<string, unknown>, gitDir?: string): Promise<ValidationResult>;
+//# sourceMappingURL=version-retrograde-fence.d.ts.map

package/dist/core/archive/version-retrograde-fence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-retrograde-fence.d.ts","sourceRoot":"","sources":["../../../src/core/archive/version-retrograde-fence.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,gBAAgB,EAAc,MAAM,sBAAsB,CAAC;AAwBzE;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAoE3B"}

package/dist/core/archive/version-retrograde-fence.js

@@ -0,0 +1,103 @@
+// src/core/archive/version-retrograde-fence.ts — plan-9j Task 4
+// 沿 design §3.4.4.3 — 校验 created_by_tool_version 字段不能从高版本回降低版本
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { relative } from 'node:path';
+import { ok, failed } from '../validate/types.js';
+const execFileAsync = promisify(execFile);
+/** semver 字符串解析为可比较数组 [major, minor, patch] — 忽略 prerelease/build */
+function parseSemver(v) {
+    const m = v.match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!m)
+        return null;
+    return [parseInt(m[1] ?? '0', 10), parseInt(m[2] ?? '0', 10), parseInt(m[3] ?? '0', 10)];
+}
+/** 比较两个 semver — return >0 if a>b, <0 if a<b, 0 if equal */
+function compareSemver(a, b) {
+    const pa = parseSemver(a);
+    const pb = parseSemver(b);
+    if (!pa || !pb)
+        return 0; // 非 semver 视为相等(由 marker-schema 检 + 拒签)
+    for (let i = 0; i < 3; i++) {
+        const ai = pa[i] ?? 0;
+        const bi = pb[i] ?? 0;
+        if (ai !== bi)
+            return ai - bi;
+    }
+    return 0;
+}
+/**
+ * 校验 marker 的 created_by_tool_version 字段不能从高版本回降低版本
+ *
+ * @param markerPath marker 文件绝对路径
+ * @param marker 解析后的 Record
+ * @param gitDir 可选,git 仓库根目录(用于 `git log`);非 git 项目 → 跳过 best-effort
+ */
+export async function validateVersionRetrograde(markerPath, marker, gitDir) {
+    const currentVersion = marker.created_by_tool_version;
+    // 1. 字段缺失 → 跳过(老 marker 兼容)
+    if (typeof currentVersion !== 'string')
+        return ok();
+    // 2. 非 git 项目 → 跳过 best-effort(v3 MAJOR 1:用 rev-parse 真实判断,不是仅看 gitDir 参数)
+    if (!gitDir)
+        return ok();
+    try {
+        await execFileAsync('git', ['rev-parse', '--is-inside-work-tree'], { cwd: gitDir });
+        // 在 git repo 内 → 继续走 fail-closed 路径
+    }
+    catch {
+        // 真非 git repo → 跳过 best-effort
+        return ok();
+    }
+    // 3. git log -p <marker-file> 扫描历史中 created_by_tool_version 字段值
+    let logOutput;
+    try {
+        const relPath = relative(gitDir, markerPath);
+        // v9 round 2 修(plan-9j code quality reviewer I-1):maxBuffer 50MB 沿 src/core/hash/diff.ts 同 sister-pattern
+        // 默认 1MB 在 marker 历史大量 commit 时易超额触发 ERR_CHILD_PROCESS_STDIO_MAXBUFFER → 误 fail-closed 拒签
+        const { stdout } = await execFileAsync('git', ['log', '-p', '--no-color', '--', relPath], {
+            cwd: gitDir,
+            encoding: 'utf8',
+            maxBuffer: 50 * 1024 * 1024,
+        });
+        logOutput = stdout;
+    }
+    catch (err) {
+        // v3 MAJOR 1 修订:**fail-closed git error**(不再 best-effort 全跳)
+        // 区分:已经过 rev-parse 确认是 git repo(line 上方),此时 git log 失败应视为异常,拒签
+        return failed({
+            artifact: 'marker',
+            field: 'created_by_tool_version',
+            message: `version-retrograde fence:git repo 内 git log -p 失败(${err.message});` +
+                `沿 v3 MAJOR 1 修订 — git error 在 git repo 内 fail-closed,防止 git history rewrite 篡改`,
+            file: markerPath,
+        });
+    }
+    // 4. 从 diff 中抽取所有 `created_by_tool_version: <semver>` 历史值
+    // [+\-] 前缀匹配 git diff 行首的 + / - 标记(对应该次 commit 增/删的 marker 字段值);
+    // 整块 stdout 非逐行匹配 — `+++ / ---` 文件头不含 `created_by_tool_version` 字段不会误匹
+    const versionRegex = /[+\-]\s*created_by_tool_version:\s*['"]?([\d.\-+a-zA-Z]+)['"]?/g;
+    const historyVersions = [];
+    let m;
+    while ((m = versionRegex.exec(logOutput)) !== null) {
+        if (m[1])
+            historyVersions.push(m[1]);
+    }
+    // 5. 找历史最高版本,与 currentVersion 比较
+    let highest = currentVersion;
+    for (const v of historyVersions) {
+        if (compareSemver(v, highest) > 0)
+            highest = v;
+    }
+    if (compareSemver(highest, currentVersion) > 0) {
+        return failed({
+            artifact: 'marker',
+            field: 'created_by_tool_version',
+            message: `version retrograde 检测:git history 中曾经为 ${highest},当前 ${currentVersion} — 视为 tamper;` +
+                `沿 design §3.4.4.3 — version 字段不接受从高版本回降低版本`,
+            file: markerPath,
+        });
+    }
+    return ok();
+}
+//# sourceMappingURL=version-retrograde-fence.js.map

package/dist/core/archive/version-retrograde-fence.js.map

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

package/dist/core/artifact-graph/builder.d.ts

@@ -0,0 +1,16 @@
+import type { ArtifactGraph } from './types.js';
+import { type ArtifactKind } from '../schema/index.js';
+/**
+ * 构建固定的"线性"依赖图：proposal → specs → design → tasks。
+ * 调用方传入每个 artifact 的 exists / valid 状态。
+ */
+export declare function buildGraph(states: Record<ArtifactKind, {
+    exists: boolean;
+    valid: boolean;
+}>): ArtifactGraph;
+/**
+ * 找出"可以跑"的下一个 artifact：从前到后，第一个 exists=false 或 valid=false 的就是该补/该改的。
+ * 若全部 valid → 返回 null（可以进入 apply / archive）。
+ */
+export declare function findNextArtifact(graph: ArtifactGraph): ArtifactKind | null;
+//# sourceMappingURL=builder.d.ts.map

package/dist/core/artifact-graph/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/core/artifact-graph/builder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,GAChE,aAAa,CAaf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAK1E"}

package/dist/core/artifact-graph/builder.js

@@ -0,0 +1,32 @@
+// 构建 artifact 依赖图 — spec §2.1 core/artifact-graph
+import { DEFAULT_ARTIFACTS } from '../schema/index.js';
+/**
+ * 构建固定的"线性"依赖图：proposal → specs → design → tasks。
+ * 调用方传入每个 artifact 的 exists / valid 状态。
+ */
+export function buildGraph(states) {
+    // 根据 DEFAULT_ARTIFACTS 顺序创建节点
+    const nodes = DEFAULT_ARTIFACTS.map((id) => ({
+        id,
+        exists: states[id].exists,
+        valid: states[id].valid,
+    }));
+    // 建立线性依赖边：相邻两个 artifact 之间的依赖
+    const edges = [];
+    for (let i = 0; i < DEFAULT_ARTIFACTS.length - 1; i++) {
+        edges.push({ from: DEFAULT_ARTIFACTS[i], to: DEFAULT_ARTIFACTS[i + 1] });
+    }
+    return { nodes, edges };
+}
+/**
+ * 找出"可以跑"的下一个 artifact：从前到后，第一个 exists=false 或 valid=false 的就是该补/该改的。
+ * 若全部 valid → 返回 null（可以进入 apply / archive）。
+ */
+export function findNextArtifact(graph) {
+    for (const node of graph.nodes) {
+        if (!node.exists || !node.valid)
+            return node.id;
+    }
+    return null;
+}
+//# sourceMappingURL=builder.js.map

package/dist/core/artifact-graph/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/core/artifact-graph/builder.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAGlD,OAAO,EAAE,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AAE1E;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,MAAiE;IAEjE,8BAA8B;IAC9B,MAAM,KAAK,GAAmB,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3D,EAAE;QACF,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM;QACzB,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK;KACxB,CAAC,CAAC,CAAC;IACJ,8BAA8B;IAC9B,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAE,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/artifact-graph/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/artifact-graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/artifact-graph/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/core/artifact-graph/index.js

@@ -0,0 +1,4 @@
+// artifact-graph 模块导出
+export * from './types.js';
+export * from './builder.js';
+//# sourceMappingURL=index.js.map

package/dist/core/artifact-graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/artifact-graph/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/core/artifact-graph/types.d.ts

@@ -0,0 +1,14 @@
+import type { ArtifactKind } from '../schema/index.js';
+export interface ArtifactNode {
+    id: ArtifactKind;
+    exists: boolean;
+    valid: boolean;
+}
+export interface ArtifactGraph {
+    nodes: ArtifactNode[];
+    edges: {
+        from: ArtifactKind;
+        to: ArtifactKind;
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/artifact-graph/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/artifact-graph/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,YAAY;IAE3B,EAAE,EAAE,YAAY,CAAC;IAEjB,MAAM,EAAE,OAAO,CAAC;IAEhB,KAAK,EAAE,OAAO,CAAC;CAChB;AAGD,MAAM,WAAW,aAAa;IAE5B,KAAK,EAAE,YAAY,EAAE,CAAC;IAEtB,KAAK,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,EAAE,EAAE,YAAY,CAAA;KAAE,EAAE,CAAC;CACnD"}

package/dist/core/artifact-graph/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/artifact-graph/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/artifact-graph/types.ts"],"names":[],"mappings":""}

package/dist/core/backlog/assets/backlog-readme.md

@@ -0,0 +1,11 @@
+# Backlog Registry
+
+`active.md` / `archived.md` 是 **生成产物** —— 由 `/forge:archive`(或 `forge backlog`)自动重生成,**请勿手编**。本 `README.md` 是一次性静态种子,可本地补充。
+
+- `active.md` —— 当前未决 scope-entry(Future Work + Out of Scope 计入待办数;Non-Goals 单列不计入)。
+- `archived.md` —— tombstone:已被后续 change 经 `superseding_entries` 认领为 superseded / obsolete / completed / inherited 的 entry。
+
+数据源:`forge/changes/archive/*/{proposal,design}.md` 内的 `forge-scope-entries/v1` YAML 块。
+富字段(priority / reason 等)须写进源头 scope-entry,手编 active.md / archived.md 会被下次重生成冲掉。
+
+查询:`forge backlog list`。CI 守门:`forge backlog --check`。

package/dist/core/backlog/index.d.ts

@@ -0,0 +1,20 @@
+export * from './render.js';
+export interface GenerateBacklogResult {
+    /** 待办数(future-work + out-of-scope) */
+    openCount: number;
+    /** warning 数 */
+    warningCount: number;
+    /** 渲染出的两份 markdown(供 --check 比对,不必重新读盘) */
+    activeMd: string;
+    archivedMd: string;
+}
+/** 聚合 + 渲染,返回两份 markdown(纯计算,不写盘) */
+export declare function buildBacklog(forgeRoot: string): Promise<GenerateBacklogResult>;
+/** 聚合 + 渲染 + 写盘到 forge/backlog/(README 仅首写) */
+export declare function generateBacklog(forgeRoot: string): Promise<GenerateBacklogResult>;
+/**
+ * 比对磁盘上的 forge/backlog/{active,archived}.md 与重生成结果。
+ * 返回陈旧文件名列表(空数组 = 一致)。供 `forge backlog --check`(CI staleness 守门,spec §7.2)。
+ */
+export declare function checkBacklogStale(forgeRoot: string): Promise<string[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/backlog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/backlog/index.ts"],"names":[],"mappings":"AAeA,cAAc,aAAa,CAAC;AAM5B,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQpF;AAED,+CAA+C;AAC/C,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAWvF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiB5E"}