allin-governance

把 allin 治理中枢 里本来就通用的部分装成一个可安装件 —— 让外部的人能直接消费， 而不是先读 86 份文档。

pip install allin-governance

allin-governance --version
allin-governance init <目录>               # 生成可跑的最小治理骨架
allin-governance repocheck <目录>          # 离线仓库体检
allin-governance repocheck --help

它解决什么

一个人管多个仓库时，塌方的不是代码能力，而是这几件事：

所以这套东西的取向是：给人看的规矩变成给机器跑的门禁，给机器跑的门禁要有给人看的账。

用法（Usage）

# 给一个空目录装上治理骨架（或装进已有仓：只合并不覆盖）
allin-governance init <目录>

# 体检当前目录（最常用）
allin-governance repocheck .

# 体检一个发布区（每个仓一个项目）
allin-governance repocheck <发布区>

# 进 CI：有 error 级问题即非 0 退出
allin-governance repocheck . --fail-on error

# 其他常用开关
allin-governance repocheck . --format json --output report.json
allin-governance repocheck . --skip-rules 1,7        # 临时豁免误报
allin-governance repocheck --dump-profile            # 列出全部 30 条规则（不扫描）

示例输出

根目录：.
发现项目数：2
健康分：均值 6.0 / 最低 6.0　通过率 100%

== kernel  (kernel)  健康分 6.0
   ✓ 无达到阈值的问题
   (跳过 10 项：no-dotgit, no-workflow, user)

当前能力

init —— 生成可跑的最小治理骨架

allin-governance init <目录>
cd <目录> && npm run check:governance     # 需要 Node >= 22.18；实测 14/14 exit 0

生成 14 道可执行门禁 + 文档四分类 + registry.json + 基线棘轮 + 生成清单。 判据不是「写了多少文件」，而是：一个陌生目录 init 完，那条命令必须 exit 0。

为什么是 14 道而不是全部 20 道 —— 这是实测出来的边界，不是拍脑袋：

三条设计约束：

• 门禁脚本必须物理在仓里。 g00-meta 的第一条判据就是「注册表里的 script 必须在仓内」（注册表不是愿望清单）。所以 init 拷快照，不是让门禁住在 site-packages —— 否则 git log 看不到判据的变更史，pip install -U 会 静默改变你的裁决结果。
• 快照可核对。 GENERATED.json 记下生成器版本与每个文件的 sha256， 任何一处被手改或被别的版本覆盖都能逐字节判出来。
• 用户内容永不被覆盖。 --force 只升级 tools/gate/governance/**； README.md / LICENSE / docs/** 只在缺失时创建。 package.json 与 .gitignore 只做合并。

repocheck —— 离线仓库体检

30 条规则，给出 0–10 健康分与 error / warn / info 三级问题； 支持 text / JSON / CSV / HTML 四种导出。

allin-governance repocheck .                    # 体检当前目录
allin-governance repocheck <发布区>             # 体检一个发布区
allin-governance repocheck . --fail-on error    # 进 CI：有 error 级问题就失败

三条硬性质（不是宣传语，是设计约束）：

• 离线只读 —— 不联网、不执行被体检的代码，只看文件与 git 元数据。
• 零第三方依赖 —— 只用标准库。装了 full 附加依赖会用更严格的库做二次校验， 不装则走内置实现，结论口径一致。
• 退出码如实 —— 体检结论全在退出码上，包装层不改写它。

与 allin 仓的关系

本包的 repocheck 与治理门禁套件 源码只有一份：真身在 allin 仓的 tools/repocheck/ 与 tools/gate/governance/，打包时由 pyproject.toml 的 package-dir 映射进来， 不复制。理由很实际：两份代码必然漂移，而判断哪份是准的成本， 远高于省下的打包麻烦。

init 是唯一的例外，而且它就该是例外：它把套件拷进目标仓。 那不是镜像，是交付物 —— 有版本、有清单（GENERATED.json）、覆盖要显式 --force。 门禁必须住在被治理的仓里，否则治理的证据链断在安装目录。

安装

pip install allin-governance            # 核心（零依赖）
pip install allin-governance[full]      # 加严格校验的附加依赖

要求 Python ≥ 3.11。

许可

MIT-0（MIT No Attribution）—— 与 allin 仓根一致。

状态

0.0.0a4 仍是占位版本系列：a0 先占住 allin-governance 这个名字， a1 修掉 a0 在 cp1252 控制台上的崩溃（中文输出未钉编码）， a2 加 verify 子命令与 init --with-exceptions，并把 sdist 修成自包含（物化构建）， a3 补收 a2 wheel 缺失的 4 份运行时事实源（包映射 sha256 对账收口）+ 门禁判据加固， a4 加 repocheck --profile 场景预设（monorepo / component）与门禁失败修法提示。 各版都不承诺 API 稳定。正式形态仍在演进，见 allin 仓的 REC-AU-21 与 CHANGELOG。