Files
marqdo/doc/design/change-m8-ratchet.md
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

2.7 KiB
Executable File
Raw Blame History

变更记录:M8 债务棘轮与呈现

状态 Implemented
日期 2026-10-22
里程碑 M8(warning-fatigue-control.md §4 棘轮 · occlusion-syntax.md §13)
改动文件 src/main.rs · tests/ratchet.rs
影响面 labels 新增 --baseline / --fail-on-increase

1. 棘轮规则

# CI:未完成项只许减少,不许增加
marqdo labels . --baseline .marqdo/pending.json --fail-on-increase
情形 行为 退出码
台账不存在 建立(写入当前计数),提示 已建立 N 0
当前 > 台账 失败,提示 未完成项增加了 K 1
当前 ≤ 台账 通过;若减少则收紧台账(N → M) 0

为什么"减少即收紧":否则债务可以先降后升,棘轮形同虚设。 收紧后台账记住新的低水位,回退到旧数量同样会失败(测试第 4 步验证)。

台账格式:

{"count": 1, "words": ["待开发", "未开发", "…"]}

记录词集是为了让"口径变了"可被审计——换词集时会看到 words 变化。


2. 为什么用棘轮而不是硬门禁

方案 老债 新债 结论
硬门禁(必须为 0) 阻塞一切 拦住 存量债立刻红一片,逼人关检查
棘轮(只拦增量) 不阻塞 拦住 ✅ 债务可见且不恶化
无门禁 不阻塞 不拦 债务无声增长

这与 warning-fatigue-control.md 的结论一致: 老账不追、新账必拦。


3. 呈现(已具备)

面 表现
expr_display / view 遮蔽渲染为 [描述](实现),桩渲染为 [描述](),实测 view output 页面含 access(
labels 人类行 文件:行 [函数] 描述 ← 命中词;--json 一个数组
check label.* 三类诊断(missing / empty_payload / ref_dangling)
MLSP labels.search · session.summary

没有做桩徽章:桩已经是 [描述]() 这个显眼形状,再加装饰是噪音; 需要计数时用 labels --count。


4. 测试

层 内容 结果
集成(1 个四步用例) 建账 → 增加失败 → 减少收紧 → 回退再次失败 ✅
全量 cargo test --release 605 passed / 0 failed(M7 后 604 + 1)

5. 变更清单

文件 变更
src/main.rs labels --baseline / --fail-on-increase;建账/收紧/违约逻辑
tests/ratchet.rs 四步棘轮用例
doc/design/change-m8-ratchet.md 本文件