Documentation
¶
Overview ¶
checks.go —— 台账的四条判据。
每条判据只做一件事,且**失败形态是变红**:有违反就是非零退出 + 指到 文件与行的文案。这里没有「警告」档——判据要么成立要么不成立, 把它降级成提示等于把它删掉。
Command ledgercheck 判演进台账自身的纪律(台账 = 单号状态的唯一真相)。
台账(docs/DISTRIBUTED-EVOLUTION-*.md)回答的是「这条单清了没」。它此前 只在散文里记这件事,机器读不出来——代价是台账 §15 形态 (a) 记着的实例: 一批单**早已由 8 个 PR 合入主干**,而接手的人按「单还挂着 open 标签」 判断「还没人做」,整条工作树作废。
现在台账是**声明面**:部署清单(cmd/deploymatrix)据此判定「某项能力还 缺不缺」,本命令据此判定「台账自己说的是不是真的」。
四条判据(都能被机器判,失败形态是变红) ¶
- **同一单号各处状态必须一致**:一处写「已合入」、另一处写「仍开着」 ⇒ 自相矛盾,当天即红(报出是哪两处)。
- **「已合入」必须带关闭 PR 号**(形如 #N):否则「已清偿」无从核验。
- **正文里被引用的单号必须在登记面登记**:漏登记 ⇒ 单号漂浮、无主。
- **关闭 PR 号本身必须形如 #N**:写成别的形态(PR-201、#abc)一律红。
另有一条结构判据:表格列数与表头不齐要报出来(不静默吞掉)。
判定面只有台账本身 ¶
解析走 internal/ledgerstatus(唯一真相),本命令不自己再读一遍 markdown—— 两处各读一遍,结论就会分叉,而分叉的方向恰好是「门禁判的和台账写的 不是一套」。
Click to show internal directories.
Click to hide internal directories.