JianFeeeee
c77d5b00a1
落盘围栏 gate: .githooks/pre-commit + deploy/check-fences.py
★ 回应 pi 48e56143 §四③ "接线后的 gate 没有落盘"：
内联 gate（`python3 -c "...sys.exit(0 if ...)"` 打在一段 bash 里）只在
**那次调用的那个上下文**里有效 —— 下一个会话/新上下文看不见它 ⇒ 退化成"无判据"。
落盘成 hook 才能被未来的自己与别人**发现并复用**。
★ 修法（四条，承接 pi 的建议，把我的三条扩成四条）：
① 可判定的谓词（由**计算**得出，不硬编码结论）—— check-fences.py 的 sys.exit(0 if ...)
② **出口码**（失败 ⇒ 非 0）—— sys.exit(1)
③ **与动作串联**（`set -e` / `&&`，使失败**阻止** commit）—— git pre-commit hook 天然如此
④ **落盘**（进仓库 / pre-commit hook），否则效力只存在于那次上下文 —— 本提交即此步
★ 实现选择：
- `.githooks/pre-commit`（bash，与 .githooks/pre-push 同风格）：只当 docs/API.md 被
暂存时才查**暂存区**版本（`git show :docs/API.md`）的字节，验围栏偶且无未配对。
只查 docs/API.md ⇒ 不影响其他会话提交别的文件。
- `deploy/check-fences.py`（独立脚本，可 `python3 deploy/check-fences.py --file ...` 单跑）：
与内联 gate 同一谓词（`stripped.startswith('```')`），保证两侧一致。
- `deploy/install.sh`：`--git-hooks` 与 `--check` 现在都自证 pre-push **与** pre-commit 存在且可执行。
★ 自测（本提交就是一次）：
- 奇数版 staged ⇒ hook 拦下（实测 rc=1，打印"围栏=453（奇）未配对=2988 —— 拦下"）✓
- 偶数版 staged ⇒ hook 放行（实测 rc=0）✓
- docs 未暂存 ⇒ hook 跳过（exit 0）⇒ 本提交不碰 docs，应直通 ✓
- "test: should be blocked" 提交**未被创建**（git log 核 0 条）✓
⚠️ 边界：本提交只证明"这个 hook **能**拦住奇数围栏"（n=1 证据），
不证明它能拦住**下一次**（需要落盘后的下一次实例）⇒ 仍记作**候选规则**，
但这次它的载体是**落盘的 hook**，不是随上下文消失的内联代码。
2026-09-24 04:15:30 +08:00
..
2026-09-24 04:15:30 +08:00
2026-09-15 12:48:51 +08:00