feat: 账本 ledger 模块（任务书 03）
一张只追加的表（序号、种类、内容、哈希），禁改禁删两条触发器。 有自己编号、只发生一次的 8 种记录加部分唯一索引，重复就报错：阶段开、阶段关、运行登记、 确认启动（确认没启动的结果也算这一条，防止同一次运行既扣次又退还）、运行结果、模型调用开始、结束、消融结算。 写入时只查四种拒收：只收开着的阶段的提交；替换必须接本人同一阶段、同一对象、同一种提交的最新一版，实现与核验类不能替换； 结果先于确认启动（没启动除外）；本轮消融已有格启动后不能关解释阶段。 写提案时作者自评拆成封存。提供打开（核对表结构版本，非账本库不改动）、追加、同步事务、读取、未完成的动作。 第一版的可见性、截止序号、通用唯一键、jev 记录和多余的前提检查已按新版任务书清掉。 三轮全新上下文审阅；flow 传错参数一类的意见按 CLAUDE.md"罕见情况怎么办"第 2 条只记录不加代码。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,158 @@
|
||||
import assert from "node:assert/strict";
|
||||
import { test } from "node:test";
|
||||
import type { Ledger } from "../src/ledger/index.ts";
|
||||
import {
|
||||
closeStage,
|
||||
critique,
|
||||
exited,
|
||||
freshLedger,
|
||||
implementation,
|
||||
notStarted,
|
||||
openStage,
|
||||
planRun,
|
||||
prediction,
|
||||
proposal,
|
||||
range,
|
||||
wrapUp,
|
||||
} from "./ledger-helpers.ts";
|
||||
|
||||
// 写入时由 ledger 拒绝的四种情况（docs/结构.md 第四部分"写入时由 ledger 拒绝的几种情况"），每种一条拒收、一条对应的正常情况。
|
||||
// 预期值来自文字：
|
||||
// 1. 只收开着的阶段（有开阶段记录、没有关阶段记录）的提交，别的拒收；
|
||||
// 2. 要替换的那一份不是本人在这个阶段、对同一个对象的最新一版 → 拒收；实现、修复、核验、消融实现、消融核验不能替换（方法.md 第五部分）；
|
||||
// 3. 运行结果写在"确认启动"之前 → 拒收；"没启动"的结果不需要启动记录（方法.md 第七部分）；
|
||||
// 4. 这一轮消融已经有格确认启动了，才来关这一轮的解释阶段 → 拒收（方法.md 4.3 ⑭）。
|
||||
|
||||
function submitWrapUp(ledger: Ledger, stageId: string, author: string, version: number, body = "收尾") {
|
||||
return ledger.append("submission", { stageId, author, target: null, item: null, version, kind: "wrapUp", content: wrapUp(body) });
|
||||
}
|
||||
|
||||
test("拒收 1：只收开着的阶段的提交：没开过的不收，关了以后不收、替换也不收；开着时收", (t) => {
|
||||
const { ledger } = freshLedger(t);
|
||||
assert.throws(() => submitWrapUp(ledger, "s1", "r1", 1), /没有开着/);
|
||||
openStage(ledger, "s1", "wrapUp", 1);
|
||||
submitWrapUp(ledger, "s1", "r1", 1);
|
||||
closeStage(ledger, "s1");
|
||||
assert.throws(() => submitWrapUp(ledger, "s1", "r2", 1), /没有开着/);
|
||||
assert.throws(() => submitWrapUp(ledger, "s1", "r1", 2, "关闭后想替换"), /没有开着/);
|
||||
assert.equal(ledger.records().filter((r) => r.kind === "submission").length, 1);
|
||||
});
|
||||
|
||||
test("拒收 2 的正常情况：替换本人在这个阶段、对同一个对象的最新一版，版本号加 1", (t) => {
|
||||
const { ledger } = freshLedger(t);
|
||||
openStage(ledger, "s1", "firstPrediction", 1);
|
||||
const slot = { stageId: "s1", author: "r1", target: "c1", item: null, kind: "firstPrediction" as const };
|
||||
ledger.append("submission", { ...slot, version: 1, content: prediction(range(1, 2, 3)) });
|
||||
ledger.append("submission", { ...slot, version: 2, content: prediction(range(1, 2, 4)) });
|
||||
ledger.append("submission", { ...slot, version: 3, content: prediction(range(1, 2, 5)) });
|
||||
assert.equal(ledger.latestSubmission(slot)?.content.version, 3);
|
||||
});
|
||||
|
||||
test("拒收 2：要替换的那一份不是最新一版、不是本人的、不是同一个对象的、不在这个阶段，都拒收", (t) => {
|
||||
const { ledger } = freshLedger(t);
|
||||
openStage(ledger, "s1", "firstPrediction", 1);
|
||||
openStage(ledger, "s2", "firstPrediction", 1);
|
||||
const slot = { stageId: "s1", author: "r1", target: "c1", item: null, kind: "firstPrediction" as const };
|
||||
ledger.append("submission", { ...slot, version: 1, content: prediction(range(1, 2, 3)) });
|
||||
ledger.append("submission", { ...slot, version: 2, content: prediction(range(1, 2, 4)) });
|
||||
const next = { ...slot, version: 3, content: prediction(range(1, 2, 6)) };
|
||||
// 想替换第 1 版，但最新是第 2 版。
|
||||
assert.throws(() => ledger.append("submission", { ...slot, version: 2, content: prediction(range(0, 2, 4)) }), /最新是第 2 版/);
|
||||
// 要替换的第 3 版不存在。
|
||||
assert.throws(() => ledger.append("submission", { ...slot, version: 4, content: prediction(range(1, 2, 6)) }), /最新是第 2 版/);
|
||||
// 不是本人的、不是同一个对象的、不在这个阶段的：本人在那里还没有交过。
|
||||
assert.throws(() => ledger.append("submission", { ...next, author: "r2" }), /还没有交过/);
|
||||
assert.throws(() => ledger.append("submission", { ...next, target: "c2" }), /还没有交过/);
|
||||
assert.throws(() => ledger.append("submission", { ...next, stageId: "s2" }), /还没有交过/);
|
||||
assert.equal(ledger.latestSubmission(slot)?.content.version, 2);
|
||||
});
|
||||
|
||||
test("拒收 2：同一个人对同一个候选的几份挑刺按各自的编号分开算版本", (t) => {
|
||||
const { ledger } = freshLedger(t);
|
||||
openStage(ledger, "s1", "critique", 1);
|
||||
const slot = { stageId: "s1", author: "r1", target: "c1", kind: "critique" as const };
|
||||
ledger.append("submission", { ...slot, item: "k1", version: 1, content: critique("第一份") });
|
||||
ledger.append("submission", { ...slot, item: "k2", version: 1, content: critique("第二份") });
|
||||
ledger.append("submission", { ...slot, item: "k1", version: 2, content: critique("第一份改") });
|
||||
assert.throws(() => ledger.append("submission", { ...slot, item: "k3", version: 2, content: critique("x") }), /还没有交过/);
|
||||
});
|
||||
|
||||
test("拒收 2：实现、修复、核验、消融实现、消融核验只收第一版，不能替换", (t) => {
|
||||
const { ledger } = freshLedger(t);
|
||||
openStage(ledger, "impl", "implementation", 1, ["e1"]);
|
||||
openStage(ledger, "fix", "implementation", 1, ["e1"]);
|
||||
openStage(ledger, "ver", "verification", 1, ["v1"]);
|
||||
openStage(ledger, "aimpl", "ablationImplementation", 1, ["e1"]);
|
||||
openStage(ledger, "aver", "ablationVerification", 1, ["v1"]);
|
||||
const base = { author: "e1", target: "c1", item: null };
|
||||
const verification = { clauses: [], factors: [], safeguards: [], unassigned: [], body: "无" };
|
||||
const ablImpl = { alsoOff: [], cannotRun: null, concerns: "无" };
|
||||
const cases = [
|
||||
{ ...base, stageId: "impl", kind: "implementation" as const, content: implementation() },
|
||||
{ ...base, stageId: "fix", kind: "repair" as const, content: implementation("修复") },
|
||||
{ ...base, author: "v1", stageId: "ver", kind: "verification" as const, content: verification },
|
||||
{ ...base, stageId: "aimpl", target: "cell1", kind: "ablationImplementation" as const, content: ablImpl },
|
||||
{ ...base, author: "v1", stageId: "aver", target: "cell1", kind: "ablationVerification" as const, content: { factors: [] } },
|
||||
];
|
||||
for (const c of cases) {
|
||||
ledger.append("submission", { ...c, version: 1 });
|
||||
assert.throws(() => ledger.append("submission", { ...c, version: 2 }), /不能替换/, c.kind);
|
||||
}
|
||||
});
|
||||
|
||||
test("拒收 2：版本号只在同一种提交里接：不能替换的实现不能被别的种类顶替，提案和挑刺用同一个编号也接不上", (t) => {
|
||||
// 同一位置上，实现 v1 之后交收尾 v2 拒收，最新一版仍是实现；提案和挑刺用同一个编号，版本号各算各的。
|
||||
const { ledger } = freshLedger(t);
|
||||
openStage(ledger, "impl", "implementation", 1, ["e1"]);
|
||||
const implSlot = { stageId: "impl", author: "e1", target: "c1", item: null };
|
||||
ledger.append("submission", { ...implSlot, version: 1, kind: "implementation", content: implementation() });
|
||||
assert.throws(() => ledger.append("submission", { ...implSlot, version: 2, kind: "wrapUp", content: wrapUp() }), /还没有交过/);
|
||||
assert.equal(ledger.latestSubmission({ ...implSlot, kind: "implementation" })?.content.kind, "implementation");
|
||||
|
||||
openStage(ledger, "mix", "proposal", 1);
|
||||
const mixSlot = { stageId: "mix", author: "r1", target: null, item: "x1" };
|
||||
ledger.append("submission", { ...mixSlot, version: 1, kind: "proposal", content: proposal(range(1, 2, 3)) });
|
||||
assert.throws(() => ledger.append("submission", { ...mixSlot, version: 2, kind: "critique", content: critique() }), /还没有交过/);
|
||||
assert.equal(ledger.latestSubmission({ ...mixSlot, kind: "critique" }), undefined);
|
||||
});
|
||||
|
||||
test("拒收 3：没有确认启动就写运行结果，拒收；确认启动后可以写", (t) => {
|
||||
const { ledger } = freshLedger(t);
|
||||
planRun(ledger, "run1", "forward", 1);
|
||||
assert.throws(() => ledger.append("runResult", { run: "run1", process: exited, judged: null }), /还没有"确认启动"/);
|
||||
ledger.append("runStarted", { run: "run1" });
|
||||
ledger.append("runResult", { run: "run1", process: exited, judged: null });
|
||||
});
|
||||
|
||||
test("拒收 3 的例外：确认没启动的结果不需要启动记录", (t) => {
|
||||
const { ledger } = freshLedger(t);
|
||||
planRun(ledger, "run1", "forward", 1);
|
||||
ledger.append("runResult", { run: "run1", process: notStarted, judged: null });
|
||||
assert.deepEqual(ledger.pending().runs, []);
|
||||
});
|
||||
|
||||
test("拒收 4：这一轮已经有消融格确认启动，就不能关这一轮的解释阶段", (t) => {
|
||||
const { ledger } = freshLedger(t);
|
||||
openStage(ledger, "expl", "explanation", 2);
|
||||
planRun(ledger, "cellrun", "ablation", 2);
|
||||
ledger.append("runStarted", { run: "cellrun" });
|
||||
assert.throws(() => closeStage(ledger, "expl"), /解释冻结必须早于任何一格启动/);
|
||||
assert.equal(ledger.stageClosed("expl"), false);
|
||||
});
|
||||
|
||||
test("拒收 4 的正常情况：只登记没启动、别的轮的消融启动、本轮正向启动，都不挡关解释阶段；关别的阶段不受限", (t) => {
|
||||
const { ledger } = freshLedger(t);
|
||||
openStage(ledger, "expl", "explanation", 2);
|
||||
planRun(ledger, "cell-planned", "ablation", 2); // 只登记，还没确认启动
|
||||
planRun(ledger, "cell-round1", "ablation", 1);
|
||||
ledger.append("runStarted", { run: "cell-round1" });
|
||||
planRun(ledger, "fwd-round2", "forward", 2);
|
||||
ledger.append("runStarted", { run: "fwd-round2" });
|
||||
closeStage(ledger, "expl");
|
||||
assert.equal(ledger.stageClosed("expl"), true);
|
||||
openStage(ledger, "wrap", "wrapUp", 2);
|
||||
planRun(ledger, "cell2", "ablation", 2);
|
||||
ledger.append("runStarted", { run: "cell2" });
|
||||
closeStage(ledger, "wrap");
|
||||
assert.equal(ledger.stageClosed("wrap"), true);
|
||||
});
|
||||
Reference in New Issue
Block a user