Files
marqdo/tests/ratchet.rs
T
cflmy 34b0911218 feat(labels): M8 债务棘轮 — --baseline + --fail-on-increase
规则:未完成项只许减少,不许增加。
- 台账不存在 → 建立(写入当前计数)并提示,exit 0
- 当前 > 台账 → 失败并提示"未完成项增加了 K",exit 1
- 当前 ≤ 台账 → 通过;若减少则**收紧**台账(N → M)

为什么减少即收紧:否则债务可先降后升,棘轮形同虚设;
收紧后回退到旧数量同样失败(测试第 4 步验证)。

台账格式 {"count":N,"words":[…]},记录词集使"口径变更"可审计。

为什么用棘轮而非硬门禁:硬门禁(必须为 0)会让存量债立刻红一片、逼人关检查;
棘轮做到"老账不追、新账必拦",与防疲劳机制的结论一致。

呈现面复核:expr_display / view 把遮蔽渲染为 [描述](实现)、桩为 [描述](),
实测 view output 页面含 access(;未做桩徽章——桩已是显眼形状,再加装饰是噪音。

测试:四步集成用例(建账 → 增加失败 → 减少收紧 → 回退再次失败);
全量 605 passed / 0 failed(M7 后 604 + 1)。

文档:doc/design/change-m8-ratchet.md
2026-10-22 15:34:07 +08:00

74 lines
2.3 KiB
Rust

//! `<TAB>` M8: label-debt ratchet (`--baseline` + `--fail-on-increase`).
use std::path::PathBuf;
use std::process::Command;
fn workdir(tag: &str) -> PathBuf {
let dir = std::env::temp_dir().join(format!("marqdo-ratchet-{tag}-{}", std::process::id()));
let _ = std::fs::remove_dir_all(&dir);
std::fs::create_dir_all(&dir).unwrap();
dir
}
fn write_doc(dir: &PathBuf, stubs: usize) {
let mut s = String::from("---\nmarkup: occlusion\n---\n\n# main\n\n");
for i in 0..stubs {
s.push_str(&format!("**v{i} = [功能{i},待开发](None)**\n"));
}
s.push_str("> print text=\"ok\"\n");
std::fs::write(dir.join("a.mq.md"), s).unwrap();
}
fn labels(dir: &PathBuf, baseline: &str) -> (i32, String) {
let out = Command::new(env!("CARGO_BIN_EXE_marqdo"))
.args([
"labels",
"a.mq.md",
"--baseline",
baseline,
"--fail-on-increase",
])
.current_dir(dir)
.output()
.expect("run labels");
(
out.status.code().unwrap_or(1),
format!(
"{}{}",
String::from_utf8_lossy(&out.stdout),
String::from_utf8_lossy(&out.stderr)
),
)
}
#[test]
fn ratchet_seeds_fails_on_increase_and_tightens() {
let dir = workdir("main");
let ledger = ".marqdo/pending.json";
// 1) Seed: first run creates the ledger and passes.
write_doc(&dir, 2);
let (code, text) = labels(&dir, ledger);
assert_eq!(code, 0, "{text}");
assert!(text.contains("已建立 2"), "{text}");
// 2) Increase: one more stub → exit 1.
write_doc(&dir, 3);
let (code, text) = labels(&dir, ledger);
assert_eq!(code, 1, "debt growth must fail: {text}");
assert!(text.contains("未完成项增加了 1"), "{text}");
// 3) Decrease: ratchet tightens back so it cannot regrow.
write_doc(&dir, 1);
let (code, text) = labels(&dir, ledger);
assert_eq!(code, 0, "{text}");
assert!(text.contains("棘轮收紧"), "{text}");
let body = std::fs::read_to_string(dir.join(ledger)).unwrap();
assert!(body.contains("\"count\":1"), "{body}");
// 4) Now 2 is again a violation (the ledger remembers 1).
write_doc(&dir, 2);
let (code, _) = labels(&dir, ledger);
assert_eq!(code, 1);
}