规则:未完成项只许减少,不许增加。
- 台账不存在 → 建立(写入当前计数)并提示,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
74 lines
2.3 KiB
Rust
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);
|
|
}
|