guardrail-engine 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (155) hide show
  1. guardrail_engine-0.2.0/AGENTS.md +168 -0
  2. guardrail_engine-0.2.0/CHANGELOG.md +235 -0
  3. guardrail_engine-0.2.0/LICENSE +21 -0
  4. guardrail_engine-0.2.0/MANIFEST.in +23 -0
  5. guardrail_engine-0.2.0/PKG-INFO +711 -0
  6. guardrail_engine-0.2.0/README.en.md +685 -0
  7. guardrail_engine-0.2.0/README.md +638 -0
  8. guardrail_engine-0.2.0/VERSION +1 -0
  9. guardrail_engine-0.2.0/agentguard/__init__.py +16 -0
  10. guardrail_engine-0.2.0/agentguard/_shell.py +9 -0
  11. guardrail_engine-0.2.0/agentguard/cli.py +32 -0
  12. guardrail_engine-0.2.0/agentguard/mcp.py +25 -0
  13. guardrail_engine-0.2.0/checks/agents_md_check.py +169 -0
  14. guardrail_engine-0.2.0/checks/encoding_ruleset.py +122 -0
  15. guardrail_engine-0.2.0/checks/eslint_check.py +30 -0
  16. guardrail_engine-0.2.0/checks/example_code_check.py +162 -0
  17. guardrail_engine-0.2.0/checks/example_ruleset.py +176 -0
  18. guardrail_engine-0.2.0/checks/external_adapter.py +358 -0
  19. guardrail_engine-0.2.0/checks/file_types.py +55 -0
  20. guardrail_engine-0.2.0/checks/harness_guard.py +342 -0
  21. guardrail_engine-0.2.0/checks/harness_self_check.py +306 -0
  22. guardrail_engine-0.2.0/checks/registry.py +58 -0
  23. guardrail_engine-0.2.0/checks/registry_loader.py +47 -0
  24. guardrail_engine-0.2.0/checks/rule_base.py +923 -0
  25. guardrail_engine-0.2.0/checks/semgrep_check.py +31 -0
  26. guardrail_engine-0.2.0/config/harness.local.example.toml +64 -0
  27. guardrail_engine-0.2.0/config/harness.toml +96 -0
  28. guardrail_engine-0.2.0/docs/THREAT-MODEL.en.md +241 -0
  29. guardrail_engine-0.2.0/docs/THREAT-MODEL.md +241 -0
  30. guardrail_engine-0.2.0/docs/adr/0001-packaging-principles.en.md +30 -0
  31. guardrail_engine-0.2.0/docs/adr/0001-packaging-principles.md +30 -0
  32. guardrail_engine-0.2.0/docs/packaging/COMPAT.en.md +64 -0
  33. guardrail_engine-0.2.0/docs/packaging/COMPAT.md +64 -0
  34. guardrail_engine-0.2.0/docs/packaging/INSTALL.en.md +377 -0
  35. guardrail_engine-0.2.0/docs/packaging/INSTALL.md +378 -0
  36. guardrail_engine-0.2.0/docs/packaging/OPENCLAW.en.md +66 -0
  37. guardrail_engine-0.2.0/docs/packaging/OPENCLAW.md +66 -0
  38. guardrail_engine-0.2.0/docs/packaging/RUNBOOK.en.md +242 -0
  39. guardrail_engine-0.2.0/docs/packaging/RUNBOOK.md +242 -0
  40. guardrail_engine-0.2.0/golden-patterns/endtoend/task-management.md +153 -0
  41. guardrail_engine-0.2.0/golden-patterns/index.md +95 -0
  42. guardrail_engine-0.2.0/golden-patterns/patterns/backend/controller-repository.md +164 -0
  43. guardrail_engine-0.2.0/golden-patterns/patterns/backend/validation-and-errors.md +113 -0
  44. guardrail_engine-0.2.0/golden-patterns/patterns/cross-cutting/config-and-env.md +98 -0
  45. guardrail_engine-0.2.0/golden-patterns/patterns/cross-cutting/logging.md +89 -0
  46. guardrail_engine-0.2.0/golden-patterns/patterns/web/form-dialog.md +153 -0
  47. guardrail_engine-0.2.0/golden-patterns/patterns/web/list-page.md +209 -0
  48. guardrail_engine-0.2.0/golden-patterns/patterns/web/request-layer.md +98 -0
  49. guardrail_engine-0.2.0/golden-patterns/reference/backend/ApiResult.cs +13 -0
  50. guardrail_engine-0.2.0/golden-patterns/reference/backend/AppDbContext.cs +10 -0
  51. guardrail_engine-0.2.0/golden-patterns/reference/backend/GlobalExceptionMiddleware.cs +58 -0
  52. guardrail_engine-0.2.0/golden-patterns/reference/backend/TaskConstants.cs +19 -0
  53. guardrail_engine-0.2.0/golden-patterns/reference/backend/TaskContracts.cs +45 -0
  54. guardrail_engine-0.2.0/golden-patterns/reference/backend/TaskController.cs +78 -0
  55. guardrail_engine-0.2.0/golden-patterns/reference/backend/TaskEntity.cs +14 -0
  56. guardrail_engine-0.2.0/golden-patterns/reference/backend/TaskRepository.cs +167 -0
  57. guardrail_engine-0.2.0/golden-patterns/reference/config/runtime-config.js +13 -0
  58. guardrail_engine-0.2.0/golden-patterns/reference/web/request.js +43 -0
  59. guardrail_engine-0.2.0/golden-patterns/reference/web/task-form.vue +94 -0
  60. guardrail_engine-0.2.0/golden-patterns/reference/web/task-list.vue +209 -0
  61. guardrail_engine-0.2.0/golden-patterns/templates/00_/350/214/203/345/274/217/345/210/266/351/200/240/346/250/241/346/235/277.md +92 -0
  62. guardrail_engine-0.2.0/guardrail_engine/__init__.py +20 -0
  63. guardrail_engine-0.2.0/guardrail_engine/_shell.py +421 -0
  64. guardrail_engine-0.2.0/guardrail_engine/cli.py +1972 -0
  65. guardrail_engine-0.2.0/guardrail_engine/mcp.py +652 -0
  66. guardrail_engine-0.2.0/guardrail_engine.egg-info/PKG-INFO +711 -0
  67. guardrail_engine-0.2.0/guardrail_engine.egg-info/SOURCES.txt +153 -0
  68. guardrail_engine-0.2.0/guardrail_engine.egg-info/dependency_links.txt +1 -0
  69. guardrail_engine-0.2.0/guardrail_engine.egg-info/entry_points.txt +3 -0
  70. guardrail_engine-0.2.0/guardrail_engine.egg-info/top_level.txt +2 -0
  71. guardrail_engine-0.2.0/harness/_batch.py +43 -0
  72. guardrail_engine-0.2.0/harness/_config.py +754 -0
  73. guardrail_engine-0.2.0/harness/_engine_meta.py +78 -0
  74. guardrail_engine-0.2.0/harness/_eol_policy.py +260 -0
  75. guardrail_engine-0.2.0/harness/_errors.py +18 -0
  76. guardrail_engine-0.2.0/harness/_init_marker.py +57 -0
  77. guardrail_engine-0.2.0/harness/_protected.py +55 -0
  78. guardrail_engine-0.2.0/harness/_validate.py +387 -0
  79. guardrail_engine-0.2.0/harness/_yaml_compat.py +146 -0
  80. guardrail_engine-0.2.0/harness/agents/auto-gate.py +253 -0
  81. guardrail_engine-0.2.0/harness/coverage.py +510 -0
  82. guardrail_engine-0.2.0/harness/hook_dirs.py +39 -0
  83. guardrail_engine-0.2.0/harness/hooks/post-edit.py +105 -0
  84. guardrail_engine-0.2.0/harness/hooks/pre-commit.py +291 -0
  85. guardrail_engine-0.2.0/harness/hooks/pre-edit.py +33 -0
  86. guardrail_engine-0.2.0/harness/hooks-dir/commit-msg +156 -0
  87. guardrail_engine-0.2.0/harness/hooks-dir/pre-commit +146 -0
  88. guardrail_engine-0.2.0/harness/protected-patterns.txt +36 -0
  89. guardrail_engine-0.2.0/harness/run_gate.py +981 -0
  90. guardrail_engine-0.2.0/integrations/README.en.md +35 -0
  91. guardrail_engine-0.2.0/integrations/README.md +35 -0
  92. guardrail_engine-0.2.0/integrations/agent-rule-snippet.md +32 -0
  93. guardrail_engine-0.2.0/integrations/claude-code/README.md +69 -0
  94. guardrail_engine-0.2.0/integrations/codebuddy/README.md +129 -0
  95. guardrail_engine-0.2.0/integrations/codex/README.md +109 -0
  96. guardrail_engine-0.2.0/integrations/guardrail-engine-skill/SKILL.md +134 -0
  97. guardrail_engine-0.2.0/integrations/hermes/README.md +36 -0
  98. guardrail_engine-0.2.0/integrations/hooks/agentguard-gate-shim.py +98 -0
  99. guardrail_engine-0.2.0/integrations/hooks/agentguard-gate.py +826 -0
  100. guardrail_engine-0.2.0/integrations/opencode/README.md +62 -0
  101. guardrail_engine-0.2.0/integrations/opencode/agentguard-gate.ts +318 -0
  102. guardrail_engine-0.2.0/integrations/plugins/README.md +42 -0
  103. guardrail_engine-0.2.0/integrations/plugins/agentguard-marketplace/.claude-plugin/marketplace.json +14 -0
  104. guardrail_engine-0.2.0/integrations/plugins/agentguard-marketplace/README.md +27 -0
  105. guardrail_engine-0.2.0/integrations/plugins/agentguard-plugin/.claude-plugin/plugin.json +8 -0
  106. guardrail_engine-0.2.0/integrations/plugins/agentguard-plugin/.mcp.json +13 -0
  107. guardrail_engine-0.2.0/integrations/plugins/agentguard-plugin/README.md +28 -0
  108. guardrail_engine-0.2.0/integrations/plugins/build_marketplace.py +93 -0
  109. guardrail_engine-0.2.0/integrations/plugins/build_plugin.py +164 -0
  110. guardrail_engine-0.2.0/integrations/plugins/verify_plugin.py +141 -0
  111. guardrail_engine-0.2.0/integrations/qoder-cn/README.md +281 -0
  112. guardrail_engine-0.2.0/integrations/qoder-cn/settings.example.json +33 -0
  113. guardrail_engine-0.2.0/integrations/trae-cn/README.md +265 -0
  114. guardrail_engine-0.2.0/integrations/trae-cn/hooks.example.json +22 -0
  115. guardrail_engine-0.2.0/integrations/zcode/README.md +201 -0
  116. guardrail_engine-0.2.0/integrations/zcode/opencode-go-proxy.py +132 -0
  117. guardrail_engine-0.2.0/integrations/zcode/zcode-go.sh +28 -0
  118. guardrail_engine-0.2.0/pyproject.toml +47 -0
  119. guardrail_engine-0.2.0/sandbox/acceptance_check.py +323 -0
  120. guardrail_engine-0.2.0/sandbox/agents_audit.py +515 -0
  121. guardrail_engine-0.2.0/sandbox/agents_scaffold.py +658 -0
  122. guardrail_engine-0.2.0/sandbox/audit_reconcile.py +421 -0
  123. guardrail_engine-0.2.0/sandbox/bootstrap.py +209 -0
  124. guardrail_engine-0.2.0/sandbox/bootstrap_agent_env.sh +424 -0
  125. guardrail_engine-0.2.0/sandbox/check_client_configs.py +423 -0
  126. guardrail_engine-0.2.0/sandbox/check_contracts.py +266 -0
  127. guardrail_engine-0.2.0/sandbox/check_mojibake.py +83 -0
  128. guardrail_engine-0.2.0/sandbox/demo_gate.py +98 -0
  129. guardrail_engine-0.2.0/sandbox/demo_gate.sh +152 -0
  130. guardrail_engine-0.2.0/sandbox/doctor.sh +374 -0
  131. guardrail_engine-0.2.0/sandbox/eol_text.py +207 -0
  132. guardrail_engine-0.2.0/sandbox/fix_paths.py +163 -0
  133. guardrail_engine-0.2.0/sandbox/global_agents.py +429 -0
  134. guardrail_engine-0.2.0/sandbox/inject_harness_pointer.py +209 -0
  135. guardrail_engine-0.2.0/sandbox/install_engine_hooks.sh +163 -0
  136. guardrail_engine-0.2.0/sandbox/install_hooks.sh +199 -0
  137. guardrail_engine-0.2.0/sandbox/install_shim.py +395 -0
  138. guardrail_engine-0.2.0/sandbox/list_entries.py +117 -0
  139. guardrail_engine-0.2.0/sandbox/mutation_smoke.py +1890 -0
  140. guardrail_engine-0.2.0/sandbox/pack_release.py +576 -0
  141. guardrail_engine-0.2.0/sandbox/render_harness_placeholders.py +260 -0
  142. guardrail_engine-0.2.0/sandbox/rollback_harness_placeholders.py +80 -0
  143. guardrail_engine-0.2.0/sandbox/run_acceptance_all.py +92 -0
  144. guardrail_engine-0.2.0/sandbox/run_tests.py +236 -0
  145. guardrail_engine-0.2.0/sandbox/setup_machine.sh +227 -0
  146. guardrail_engine-0.2.0/sandbox/sink_table.txt +52 -0
  147. guardrail_engine-0.2.0/sandbox/sweep_coverage.sh +72 -0
  148. guardrail_engine-0.2.0/sandbox/uninstall.py +536 -0
  149. guardrail_engine-0.2.0/sandbox/upgrade.py +1122 -0
  150. guardrail_engine-0.2.0/sandbox/verify_integrations.sh +364 -0
  151. guardrail_engine-0.2.0/sandbox/verify_judge.py +199 -0
  152. guardrail_engine-0.2.0/sandbox/verify_release.py +706 -0
  153. guardrail_engine-0.2.0/sandbox/where.sh +11 -0
  154. guardrail_engine-0.2.0/setup.cfg +4 -0
  155. guardrail_engine-0.2.0/setup.py +78 -0
@@ -0,0 +1,168 @@
1
+ # Guardrail Engine(原 AgentGuard)—— 统一门禁工程地图(所有 AI agent 通用)
2
+
3
+ > 本文件是给任何 AI agent 读的「这是哪里、有哪些规则、怎么触发」。Claude Code /
4
+ > Codex / OpenCode / CodeBuddy / Hermes 只要能执行 shell 命令即可遵守本工程。
5
+ > 核心原则:**人类掌舵,Agent 执行。门禁是代码库的硬边界,不是建议。**
6
+
7
+ ## 这个工程是什么
8
+
9
+ Guardrail Engine 是一个**通用代码门禁框架**,用于在编辑期和提交期自动检查代码是否符合团队约定。
10
+ 各仓库通过固定路径引用本工程。约束规则全部集中在 `checks/`,策略集中在配置,
11
+ **规则是单一事实源,不要在业务代码仓库里各写一套。**
12
+
13
+ ## 仓库结构速览
14
+
15
+ - `config/harness.toml` —— gate 清单与策略:enabled / strict|loose / run_on / 行尾。
16
+ `[repos]` 段**只声明键名、值一律留空**(受管仓库名单是团队策略,与机器无关;键名不许动)。
17
+ - `config/harness.local.toml` —— **本机事实**:各仓库在自己磁盘上的路径(git 忽略)。
18
+ 键值留空 = 这台机器没配该仓,逐条 `⊘` 提示但不阻断;键名不在共享配置里才是真配置错。
19
+ 改策略不碰脚本。
20
+ - `checks/*.py` —— 各端门禁脚本与规则集。
21
+ - `golden-patterns/index.md` —— 黄金范式索引:按任务组织的**代码骨架库**(请求层 / 列表页 /
22
+ 表单弹窗 / 后端分层 / 校验 / 日志 / 配置 + 业务端到端范本)。规则命中时输出
23
+ `📖 See: <仓库相对路径>`,顺着它读;`reference/` 是完整参考实现,`templates/` 教怎么造新范式。
24
+ - `harness/run_gate.py` —— 统一调度器(按 gate 名调 checks)。
25
+ - `harness/coverage.py` —— 覆盖度自评(`run_gate.py --coverage`):哪些规则真触发过、哪些一次没响。
26
+ - `harness/agents/auto-gate.py` —— AI agent 通用入口(在仓库目录下跑,自动识别 gate)。
27
+ - `harness/hooks/*` —— git hook 触发点(pre-edit / post-edit / pre-commit)。
28
+ - `sandbox/install_hooks.sh` —— 给端仓库装 git pre-commit(agent 无关的强制层)。
29
+
30
+ ## Agent 必须遵守的规则
31
+
32
+ 1. **改码前**(pre-edit):确保改动清单 / 方案已和用户确认,不要自己设计大改动突袭。
33
+ 2. **改码后进门禁**:在改动仓库的根目录下,或带上 `--repo`,跑通用门禁——
34
+ ```
35
+ python <HARNESS>/harness/agents/auto-gate.py
36
+ ```
37
+ 或指定 repo:
38
+ ```
39
+ python <HARNESS>/harness/run_gate.py <gate名> <文件...>
40
+ ```
41
+ 退出码:`0` 通过 / `1` 拦截 / `2` 配置错 / `3` 非受管仓。
42
+ 3. **不加规则外的例外**:`harness-ok:` 注释只用于**文件级规则不适用**的场景,
43
+ 且必须写明理由。规则 ID 必须写对、理由必填。
44
+ 4. **不改引擎层除非被要求**:`checks/` + `harness/` + `guardrail_engine/`(含兼容壳 `agentguard/`)
45
+ 受保护,改动需在提交消息带 `[harness]` 标记。
46
+ 5. **零第三方依赖**:引擎层只用 Python 标准库,新增依赖需明确批准。外部 ESLint / Semgrep
47
+ 适配 gate 是**可选的外部进程**(默认关闭),不计入引擎依赖;工具没装时开启该 gate 会
48
+ fail-closed 到 rc=2。
49
+
50
+ ## 行内豁免(合规写法被误报时的唯一出路)
51
+
52
+ 有些规则机械判不出来。这时**不要改规则、不要删代码绕过**,在命中行的
53
+ **本行或紧邻上一行**加标记:
54
+
55
+ ```js
56
+ // harness-ok: NO-CONSOLE 调试日志已用条件封装
57
+ if (DEBUG) console.log("debug info")
58
+ ```
59
+
60
+ - 标记必须落在**注释**里 —— 字符串字面量里的不算。
61
+ - 规则 ID 必须写对,**并且跟一句非空理由**。
62
+ - 先看清这条规则**是否适用**。被一条明显不适用的规则拦住 → 改配置或报给维护者。
63
+
64
+ ## 黄金范式(写码前的正向指引)
65
+
66
+ 门禁回答「不能这么写」,`golden-patterns/` 回答「照这个写」。它不是规则清单,而是按
67
+ 「你要写什么」组织的已验收骨架:请求层、列表页、表单弹窗、后端分层、校验与错误、日志、配置,
68
+ 外加一个从常量到页面的业务全链范本。规则类声明 `see` 后,命中输出会多一行
69
+ `📖 See: <仓库相对路径>` —— 被拦的那一刻先读它,再改代码。
70
+
71
+ 入口是 `golden-patterns/index.md`;`reference/` 下的正面样板必须自己也能过门禁(测试会跑)。
72
+ 团队新范式放进 `golden-patterns/patterns/<端或主题>/` 或 `golden-patterns/endtoend/`,
73
+ 先读 `golden-patterns/templates/00_范式制造模板.md`,并在规则上写 `see` 对接。
74
+
75
+ ## Git 强制层(无需 agent 配合,自动生效)
76
+
77
+ - 端仓库 `pre-commit`:commit 先跑对应门禁,未通过阻断。
78
+ - 端仓库 `harness_guard`:防 AI 为过门禁而暗改受保护文件。
79
+ - 本工程自身两层钩子:checks 语法门禁 + commit-msg 需 `[harness]` 标记(防改坏门禁脚本)。
80
+
81
+ ## 保护循环(防 AI 改门禁敷衍了事)
82
+
83
+ - 改 `checks/*.py` 或 `config/harness.toml` 属于 harness 维护,需 commit 消息带 `[harness]`。
84
+ - 带 `[harness]` 的提交还要在消息末尾加一行 `Engine-Sha: <16 位哈希>`,值取自
85
+ `python harness/run_gate.py --engine-sha`;CI 会按该提交内容重算并比对(不一致即失败)。
86
+ 台账里的 `engine_sha` 靠这组尾注归因(`guardrail_engine/cli.py log --verify --engine`)。
87
+ - 规则对齐真实架构,别照搬教条。
88
+
89
+ ## 快速命令
90
+
91
+ ```bash
92
+ # 列出所有 gate
93
+ python harness/run_gate.py --list
94
+
95
+ # 自动识别并检查改动
96
+ python harness/agents/auto-gate.py
97
+
98
+ # 指定 gate 定向检查
99
+ python harness/run_gate.py <gate> <文件...>
100
+
101
+ # 指定 gate 全量扫描
102
+ python harness/run_gate.py <gate> --all
103
+
104
+ # 配置体检(全舰队 AGENTS.md 检查也在这里;提交期只查本次目标仓)
105
+ python harness/run_gate.py --validate
106
+
107
+ # 门禁子进程时限(秒,默认 1800;超时杀整棵进程树、按 rc=2 处理,台账记 timed_out)
108
+ export GUARDRAIL_GATE_TIMEOUT=1800
109
+
110
+ # 运行摘要
111
+ python harness/run_gate.py --summary
112
+
113
+ # 覆盖度报告
114
+ python harness/run_gate.py --coverage
115
+
116
+ # 安装提交 hook
117
+ sh sandbox/install_hooks.sh <gate>
118
+
119
+ # 安装编辑期转发器
120
+ python sandbox/install_shim.py
121
+
122
+ # 接入自检
123
+ sh sandbox/doctor.sh
124
+
125
+ # 快速测试
126
+ python sandbox/run_tests.py --fast
127
+ ```
128
+
129
+ ## 规则模型
130
+
131
+ 所有规则继承 `checks/rule_base.py` 的 `Rule` 基类。
132
+
133
+ ### 示例规则
134
+
135
+ 项目自带 3 条示例规则(`checks/example_ruleset.py`):
136
+
137
+ | 规则 ID | 检查内容 | 严重级别 |
138
+ |---|---|---|
139
+ | `NO-CONSOLE` | 禁止 `console.log` 残留 | block |
140
+ | `NO-HARDIP` | 禁止硬编码 IP 地址 | block |
141
+ | `EOL-UNIFIED` | 行尾不统一(CRLF / LF 混用) | block |
142
+
143
+ 运行示例规则:
144
+
145
+ ```bash
146
+ python checks/example_code_check.py --repo <仓库路径> --all
147
+ ```
148
+
149
+ ## 路径约定
150
+
151
+ `<HARNESS>` 指本工程根目录。求值方式(统一解析链,优先级从高到低):
152
+
153
+ ```bash
154
+ # ① 环境变量
155
+ echo "$GUARDRAIL_ENGINE_DIR"
156
+
157
+ # ② 本机配置文件(config/harness.local.toml → harness 键)
158
+ # ③ 从模块所在目录(__file__)向上找(源码树 / 安装副本自定位)
159
+ # ④ 指针文件(~/.guardrail-engine/harness.path)—— 仅 pip/wheel 形态需要
160
+
161
+ # 不确定工程根时跑
162
+ python guardrail_engine/cli.py where
163
+ ```
164
+
165
+ ## 给 Agent 的提醒
166
+
167
+ - 看不懂规则先读配置文件,不要凭感觉猜;有歧义问用户,别自行假设业务逻辑。
168
+ - 详细文档见 `README.md` 和 `docs/` 目录。
@@ -0,0 +1,235 @@
1
+ # Changelog
2
+
3
+ 版本号的单一来源是 `VERSION`。每次发版时,在升级 `VERSION` 的同一次提交里,把
4
+ `[Unreleased]` 中属于本版的内容移入 `## [<版本>] — <日期>` 段。
5
+
6
+ 本仓库自 2026-10-20 起以 MIT 协议开源。此前为内部开发阶段,其详细记录不随本仓库
7
+ 分发;本文件从首个开源版本起重新记录。
8
+
9
+ ## [Unreleased]
10
+
11
+ ### Changed
12
+
13
+ - **调度器给门禁子进程加了时限**:`run_gate` 以前用阻塞式 `subprocess.run` 跑检查脚本,
14
+ 一个卡死的脚本就是一次卡死的提交(台账实测单条全量扫描 1275s,≈21 分钟;编辑器钩子与
15
+ CI 都串在这条链上)。
16
+ 现在统一时限 `GUARDRAIL_GATE_TIMEOUT`(秒,默认 1800;旧名 `AGENTGUARD_GATE_TIMEOUT`
17
+ 仍认),超时**杀整棵进程树**并按环境错误 `rc=2` fail-closed,台账新增
18
+ `timed_out` / `timeout_s` ——「没跑完」不会被读成「通过」,事后也分得清这次 `rc=2`
19
+ 是超时还是配置错。时限写成非整数或 ≤0 按配置错处理(`rc=2`,且不执行 gate)。
20
+ - **AGENTS.md 机器无关性检查收窄到本次目标仓**:原先每次业务仓提交都追加一次**全舰队**
21
+ 扫描(本机配了几个仓就读几个),与本次改动无关的仓坏了就拦这次提交,还多一次配置读取。
22
+ 现在提交期只查 `--repo` 指定的目标仓;舰队级扫描移到 `run_gate --validate`
23
+ (CI 用 `--validate --structure-only` 时跳过)。
24
+ - **发布链改为单一构建点**:`release.yml` 的 `build` job 只跑一次 `python -m build`,
25
+ `pack_release.py --wheel` 复用同一轮 wheel;`release` 与 `publish` 都下载
26
+ `release-dist` artifact,禁止重新构建。GitHub Release 现在同时附上 PyPI 的同一份
27
+ wheel/sdist,不再出现两条构建链产出不同字节的情况。
28
+ - **artifact 不再携带 `_wheel` 构建缓存**:那是同一份 wheel 的第三份副本(下游一个
29
+ 字节都不用),之前白占 1.2 MB 与上传时间。
30
+
31
+ ### Fixed
32
+
33
+ - **大提交不再被命令行长度拖垮**:`pre-commit` / `auto-gate` / `post-edit` 把全部文件拼进
34
+ `run_gate` 的 argv,在 Windows 上超过 CreateProcess 的 32767 字符上限(约 200 个端仓
35
+ 路径)就抛 `WinError 206`;异常发生在门禁执行之前,却被外层报成「门禁未通过(rc=1)」,
36
+ 把环境问题误报成业务代码问题。现在按 `harness/_batch.py` 的预算分批调用,
37
+ `pre-commit` 展开暂存内容改走 `git checkout-index --stdin -z`;子进程起不来时统一
38
+ 按 rc=2(配置/环境)fail-closed。
39
+ - **`agents_md_check` 只认旧名**:匹配模式写死 `agentguard`,改名后 `/opt/guardrail-engine`、
40
+ `C:/tools/guardrail-engine` 这类绝对路径一个字符都匹配不上 —— 检查在新机器上形同虚设。
41
+ 现在新旧名都认;同时排除 `~/`、`$HOME/`、`%USERPROFILE%/` 开头的家园相对指针(那是
42
+ 文档推荐写法,不该被判成绝对路径)。
43
+ - **artifact 漏传隐藏文件**:`upload-artifact` 默认 `include-hidden-files: false`,
44
+ 而出货件里的 `marketplace/.claude-plugin/`、`plugins/agentguard/.claude-plugin/`、
45
+ `plugins/agentguard/.mcp.json` 全部以点开头。实测删掉这三处后 `verify_release.py`
46
+ 报 7 项不符(含整包指纹),即 release job 会以”产物不完整”失败。已显式打开
47
+ 该开关,并在 `test_pypi_publish` 里锁住。
48
+ - **评审报告 2026-11-04 全数处理**(P0×1 / P1×4 / P2×10 / P3×6,15 条独立提交):
49
+ - **P0 安装副本信任锚**:`init` 落盘的 marker 现在记 `engine_sha`,副本无 git 历史时
50
+ `gate log --verify --engine` 也能核对基线,不再只报”尚无尾注”。
51
+ - **P1-1 worktree 提交不再绕过 `[harness]` 把关**:`commit-msg` 与 `guard` 改判
52
+ git common-dir(worktree 与主检出共享),不再用字面工作树路径比较。
53
+ - **P1-2 guard 收集删除/改名**:`harness_guard` 现在能观察到受保护文件的删除与重命名,
54
+ 不再只盯修改。
55
+ - **P1-3 统一受保护路径 manifest**:`harness_guard._in_protected`、`commit-msg` 的
56
+ `grep -Ef`、`_engine_files`、`harness_self_check` 必需文件四份清单收敛到
57
+ `harness/protected-patterns.txt` 单一事实源,测试断言四处读同一份。
58
+ - **P1-4 测试夹具隔离 HOME/USERPROFILE**:夹具用 `tempfile.mkdtemp` 生成独立 HOME,
59
+ 不再污染真实用户配置目录。
60
+ - **P2-1 MCP run_cmd 超时杀整棵进程树**:`mcp.run_cmd` 改用 `Popen` +
61
+ `_shell._communicate_tree`,与 cli/run_gate 同源同纪律,超时杀整棵进程树。
62
+ - **P2-2 MCP 环境变量导入期 int() 崩溃**:`DEFAULT_TIMEOUT` / `MAX_OUTPUT` 改用
63
+ `_env_positive_int`,非整数 / ≤0 回退默认值并 warn,不再让 server 起不来。
64
+ - **P2-3 示例 gate 全量扫描剪枝**:`example_code_check.py --all` 现在跳过
65
+ `node_modules` / `.venv` / `.git` 等 vendor/VCS/缓存目录,不再把第三方代码的
66
+ `console.log` 当成业务违规。
67
+ - **P2-4 sh/TS 解释器探针要求 Python 3.11+**:9 处 sh 入口与 `integrations/opencode`
68
+ 的 pickPython 现在校验 `>=3.11`,不再接受任意 Python 3(3.10 会因 `tomllib`
69
+ 缺失而失败)。
70
+ - **P2-5 coverage --last 0/负数归 0 条**:`load_records` 的 `last` 参数现在
71
+ `≤0 → []`,与 cli `_read_jsonl` 的 L10 修复同源。
72
+ - **P2-7 CI Actions 按 SHA 固定 + Dependabot**:20 处 `uses:` 全部按 commit SHA
73
+ 固定(行尾 `# tag:` 注释保留),新增 `.github/dependabot.yml` 周更。
74
+ - **P2-9 MCP gate 名单缓存加 config mtime**:`_gate_catalog` 缓存键追加配置文件
75
+ mtime,长驻 MCP 会话中改配置后不再命中旧名单。
76
+ - **P2-10 外部适配器补 rule_base.bump**:`external_adapter.py` 每条 finding
77
+ (error/warn/waived)现在调用 `rule_base.bump`,`HARNESS_STATS_FILE` 的 `rules`
78
+ 段不再为空 dict,coverage.py 能正确统计外部工具规则的触发记录。
79
+ - **P3-1 commit-msg 链式调用死代码修复**:`set -e` 下 `if` 体失败会立即退出,
80
+ `chained_rc=$?` 永远执行不到。改用 `set +e` / `set -e` 包裹,显式捕获退出码。
81
+ - **P3-2 _cmd_verify 坏行计数不再被 extra > 0 短路**:锚定段里插入垃圾行同时后面
82
+ 有未锚定新增时,旧实现静默放过。现在无论 extra 是多少,bad 增加都出声(extra > 0
83
+ 时警告,extra == 0 时阻断)。
84
+ - **P3-3 死代码清理**:删除 `_ledger_path()`(全仓无引用)、`run_gate.py --mode`
85
+ 分支的 `skip = False`(赋值后未读取)、`opencode-go-proxy.py` 的
86
+ `self._relay(None) if False else ...`(简化为 `self._relay(b””)`)。
87
+ - **P3-4 零依赖扫描口径统一**:`harness_self_check.py` 去掉 `sandbox/`(工具脚本,
88
+ 非引擎层),显式列出 `harness/hooks` / `harness/agents`,扫描循环从 `os.walk`
89
+ 改成 `os.listdir`,与 `test_stdlib_only.py` 和 CI 同源。
90
+ - **P3-5 CI 矩阵加 Python 3.14**:本机 3.14.5 全量套件已验证兼容,提前发现未来
91
+ 版本的回归。
92
+ - **P3-6 agents_md_check 文档说明**:绝对路径检查只匹配含引擎名的路径,克隆目录被
93
+ 改名时会漏。这是刻意取舍(”宁可漏、不可误报”),在模块文档和代码注释里明说。
94
+
95
+ ## [0.2.0] — 2026-10-25
96
+
97
+ ### Changed
98
+
99
+ - **项目改名 `guardrail-engine`(迁移期保留全部旧名)**:发行包 / 导入包为
100
+ `guardrail-engine` / `guardrail_engine`,主命令 `guardrail-engine`;仓库、文档与
101
+ MCP 服务名同步。旧名不会当场失效:`agentguard` 命令与导入包、`~/.agentguard`
102
+ 配置目录、`AGENTGUARD_*` 环境变量、`.agentguard-init.json` 标记、旧 MCP 键
103
+ `agentguard` 都继续可用(新名优先,旧名兜底)。为了让老接入不断,`agentguard/`
104
+ 作为兼容壳随 wheel 一起分发,v0.3 移除。以下**保持不变**:`harness-ok:` 豁免标记、
105
+ `harness/` `checks/` `config/harness.toml` 磁盘布局、hook 文件名
106
+ `agentguard-gate.py`、Claude 插件 ID `agentguard@agentguard-tools`、OpenClaw 扩展
107
+ `extensions/agentguard`。
108
+ - 自带引擎的 wheel 与离线安装包的目录名改为 `guardrail-engine-package-v<版本>`;
109
+ `sandbox/pack_release.py` 产出的内容与校验口径同步。
110
+ - **调度层拆分**:`harness/run_gate.py` 只保留调度、台账与通知,配置体检拆到
111
+ `harness/_validate.py`,引擎版本/内容哈希拆到 `harness/_engine_meta.py`;
112
+ `_config.py` 的内置 YAML 兼容解析拆到 `_yaml_compat.py`、`ConfigError` 拆到
113
+ `_errors.py`。对外行为与既有导入名不变(`run_gate._validate` 等仍可调用),
114
+ 变异锚点与受保护文件清单同步指向新模块。
115
+ - **测试按领域重组**:`tests/` 分为 `engine/`(引擎行为)、`packaging/`(打包安装升级)、
116
+ `tooling/`(仓库工具)、`docs/`(文档一致性)、`review/`(历次评审回归)五个包,
117
+ 共享夹具 `_tmpclean.py` / `_engine_copy.py` 保留在根目录。`run_tests.py` 改为递归发现
118
+ (只下钻含 `__init__.py` 的包),`tests/lock-inventory.json` 的模块键带组前缀;
119
+ 运行命令不变。
120
+
121
+ ### Added
122
+
123
+ - **PyPI 可信发布(OIDC,不用长期 token)**:`release.yml` 新增 `publish` job ——
124
+ `python -m build` 先打 sdist、**再从 sdist** 打 wheel(sdist 漏带引擎会当场失败),
125
+ 干净 venv 安装并 `init` 冒烟后由 `pypa/gh-action-pypi-publish` 上传。首次发布前需在
126
+ PyPI 网页端登记 trusted publisher(见 `docs/packaging/RUNBOOK.md`)。
127
+ - **英文 README**:新增 `README.en.md`,与中文 `README.md` 互链。
128
+ - **外部分析器适配 gate(架构 A)**:新增 `checks/external_adapter.py` 与 `eslint_check.py` /
129
+ `semgrep_check.py`,把 ESLint / Semgrep 的 JSON 结果归一成统一 `Finding`,复用同一条输出、
130
+ `harness-ok:` 行内豁免、退出码与台账通道。两个 gate 默认 `enabled = false`;命令可用
131
+ `AGENTGUARD_ESLINT` / `AGENTGUARD_SEMGREP`(普通命令或 JSON 数组)与
132
+ `AGENTGUARD_ADAPTER_TIMEOUT` 覆盖。工具没装、超时、输出不是 JSON、ESLint 以配置错退出、
133
+ Semgrep 报告分析错误 —— 一律 `rc=2`(fail-closed,「没跑成」不等于「通过」)。
134
+ `mode` / `legacy_baseline` / `disabled_rules` 对适配 gate 不适用,规则取舍归工具自身配置。
135
+ 新增 19 条锁与 8 条变异(M146–M153)守住这些路径。
136
+ - **一键升级刷新引擎副本**:`upgrade.py` 新增 [5/7] —— 解包本包轮子自带的引擎,对 `agentguard init`
137
+ 复制出来的副本跑 `init --force`(源不依赖本机 pip 安装状态,`--skip pip` 也成立);装完**逐字节
138
+ 对账**,旧副本改名归档可回退。只认 init 写下的所有权标记,仓库与来历不明的目录一律不碰。
139
+ - **引擎内容的可追溯性**(`Engine-Sha`):带 `[harness]` 的提交在消息末尾声明本提交的
140
+ `Engine-Sha: <16 位>`,CI 的 `provenance` job 按提交内容重算比对;`run_gate.py --engine-sha`
141
+ 是只读出口(配置坏也能回答);`agentguard/cli.py log --verify --engine` 把台账里的
142
+ `engine_sha` 与提交历史中声明过的集合对账 —— 只有"用从未提交的引擎跑出的判定"会红,
143
+ 正常升级不会被误报。
144
+ - **`sandbox/demo_gate.py`**:60 秒演示的 Python 版,PowerShell / cmd 下无需 `sh` 也能跑;
145
+ 同样先证明违规被拦、再证明修复后放行。
146
+ - **`.github/CODEOWNERS`**:把 `checks/`、`harness/`、`guardrail_engine/`、`agentguard/`、`config/`、
147
+ 锁清单与 `.github/` 指给维护者;README 说明还需在 GitHub 分支保护里开启
148
+ `Require review from Code Owners` 才真正阻断合并。
149
+ - **可选规则集登记**:`checks/encoding_ruleset.py`(编码卫生)在 README 写明接线方式与两个
150
+ 易漏点(`raw=` 原始字节、`targeted=True`),模块 docstring 说明默认不注册的原因。
151
+
152
+ ### Fixed
153
+
154
+ - **第四轮评审收尾(2026-10-26)**:
155
+ - 测试重组留下的 `sys.path` 浅一层:`tests/engine/test_notify_throttle_concurrent.py` 现在
156
+ 显式指向工程根;新增 `-P`(不注入 cwd)导入锁,复现嵌入式 Python 的 `-m` 行为。
157
+ - 陈旧 pyc 用例在「本平台不复用 (mtime, 字节数) 匹配的 pyc」时 `skipTest` 并写明原因,
158
+ 不再把平台差异记成失败(不是改成 expect B)。
159
+ - `guardrail_engine/` 与兼容壳 `agentguard/` 纳入 `harness_guard` 受保护清单、CODEOWNERS
160
+ 与 `engine_sha` 内容面:改弱 CLI/MCP/`run`/`done`/`log --verify` 现在可被发现并追不到归属。
161
+ - CODEOWNERS 的锁测试路径跟上重组(`tests/tooling/test_lock_inventory.py`)。
162
+ - PyPI 长描述改用 `README.en.md`(仓库 README 仍是中文主文档);`external_adapter` 的
163
+ 命令行描述、`_tmpclean` / 锁清单注释里的旧品牌与旧路径同步清理。
164
+ - **改名后的升级链路补齐**(全量套件实测):pip 通道的产物对账同时扫
165
+ `guardrail_engine/` 与兼容壳 `agentguard/`(旧机器上只有后者时不再读成「读不到产物」);
166
+ 升级测试夹具补上新包、`integrations/guardrail-engine-skill` 源路径与新 init 标记
167
+ `.guardrail-engine-init.json`;`harness.path` 指针按迁移期双读校验。
168
+ - **外部适配层封死三个边界**(2026-10-25 第三轮评审 §4.1 / §4.2 / §4.4):
169
+ Semgrep 分支现在与 ESLint 一样检查进程退出码(`rc >= 2` = 配置/环境错误,不再被一份
170
+ 合法空 JSON 洗白);工具返回相对路径时按 `repo` 拼接后再读豁免行(`harness-ok:` 恢复
171
+ 生效);`--mode` 旗标被接收并忽略,不再以 argparse 参数错误 `rc=2` 退出;同时 `run_gate`
172
+ 对适配 gate 不再写 `mode_override` / `weakened` 台账字段(它们没有 strict/loose 可放宽,
173
+ 记了等于伪造「本次判定被削弱」)。新增 4 条锁与 M151 / M152 / M153 三条变异。
174
+ - **外部适配 gate 默认不再挂 `pre_commit`**:外部工具读工作区,提交期存在「暂存坏版本 +
175
+ 工作区改回好版本」的绕过路径(评审 §4.3)。默认只挂 `post_edit`,README 与模块文档写明
176
+ 该边界;要提交期拦截需在调用方实现暂存副本。
177
+ - **对外宣称收敛**:README 改为「退出码语义 / 豁免语法一致,严重级按工具映射」,并补
178
+ 「外部 gate 不参与静态覆盖度」与 2.4KB 全局守则的出处(评审 §4.5 / §5.2)。
179
+ - **`test_lock_inventory` 的 pyc 探针不再依赖 `-c` 的 cwd / `PYTHONPATH` 语义**:用 argv
180
+ 把模块目录显式塞进子进程 `sys.path`,嵌入式 Python 下不再把「模块找不到」误读成锁失败
181
+ (评审 §5.1)。`checks/registry.py` 头部同步为「四个 gate」。
182
+ - **`--validate` 不再对损坏的本地覆盖层报「全部健康」**:覆盖层解析失败会记成程序化信号,
183
+ 配置体检据此 `rc=2` 并点名文件与原因(单次 gate 运行仍用共享配置继续,不阻断提交)。
184
+ - `test_lock_inventory` 的陈旧字节码探针显式注入 `PYTHONPATH`:在 `PYTHONSAFEPATH=1`
185
+ 等 cwd 不在 `sys.path` 的环境下不再把「import 不到模块」误读成锁失败。
186
+ - **release / nightly 的干净 venv 冒烟改为验证 wheel 真的自带引擎**:先 `agentguard init` 到临时目录、
187
+ 检查所有权标记,再在新引擎上取版本 —— 原先指向 checkout,轮子里没有引擎也能过。
188
+ - **`harness/hooks-dir/` 的两个分发器改为 100755 入库**:POSIX 上 git 直接 exec hook,100644 会被
189
+ **静默忽略**(提交照常放行),Linux CI 与用户机器上的 hook 实际从未生效;Windows 检出看不出差别。
190
+ 新增索引 mode 看守,防止再次退回去。
191
+ - **干净环境下第二次 `agentguard init` 不再误报「源=目标」**:引擎源改为优先取自本文件的安装位置
192
+ (`<引擎根>/agentguard/..`),不再依赖 `find_root()` —— 首次 init 写完指针后它会解析到刚装出的副本,
193
+ 于是幂等重跑按重叠拒绝(本机有 `harness.local.toml` 时先命中配置,所以只在 CI 暴露)。
194
+ - 测试夹具改用仍存在的 `checks/example_code_check.py`:原先指向已删除的 `checks/pc_code_check.py`,
195
+ 在带 Node 的 CI 上 M10/M11 拿到 `rc=2`(配置错)而不是「门禁拦住」。
196
+ - `test_init_bundle` 的幂等用例改用**冻结的引擎源**:并行套件里
197
+ `TestSentinelBlocksDirtyEngine` 会故意往工程仓探针文件追加一行,活树当源时两次 init 之间
198
+ 源被改过 → 误报「内容不同」(全量并行跑实测复现)。
199
+ - 文档与元数据订正:README 的安装首步改为 `pip install .`(PyPI 未发布)、补 Git Bash
200
+ 前置条件与 `RULESETS` 登记说明、快跑耗时改为实测区间;`pyproject` 描述改为 wheel 自带引擎。
201
+ - **变异冒烟给「杀整树」补上 POSIX 半边**:`M143` 撤掉的是 Windows 分支的 taskkill `/T`,
202
+ 在 Linux 上走的是 killpg、该分支永不执行 —— Nightly L2 因此把它误报成「变异后仍然绿」。
203
+ `M143` 现声明 `blind_on: posix`,并新增互补的 `M145`(把 killpg 退化成 proc.kill,Windows 上盲),
204
+ 两条互相兜底;平台盲区名单同步登记,仍由 `test_lock_inventory` 钉死「没有一条护盾两个平台都瞎」。
205
+
206
+ ### Changed
207
+
208
+ - `agentguard init` 在副本根写下 `.agentguard-init.json`(kind / version / source),供升级识别
209
+ 所有权;幂等重跑会给旧版 init 装出来的副本补写。
210
+ - **配置主格式迁移 TOML**:`config/harness.toml` + `config/harness.local.toml`,用标准库
211
+ `tomllib` 解析;旧版 `.yaml` 仍可读,两种格式并存时 TOML 优先并出声提示被忽略的那份。
212
+
213
+ ## [0.1.0] — 2026-10-20
214
+
215
+ 开源首发(发布以 `v*` tag 为准)。
216
+
217
+ ### Added
218
+
219
+ - **开源发布**:MIT 许可证;移除业务侧组件与宿主专有引用,规则、示例与文档改为通用形态。
220
+ - **零第三方依赖**:引擎层(`checks/`、`harness/`、`agentguard/`)只使用 Python 标准库。
221
+ - **CI**(`.github/workflows/ci.yml`):Python 3.11 / 3.12 / 3.13 矩阵;零依赖静态扫描;
222
+ 快速与全量测试;`ResourceWarning` 句柄泄漏判据。
223
+ - **Release**(`.github/workflows/release.yml`):tag 与 `VERSION` 一致性校验 → 全量测试 →
224
+ 变异冒烟(验证测试锁真的会红)→ 打包 wheel 与离线安装包 → 真产物校验 →
225
+ 干净 venv 安装冒烟 → 创建 GitHub Release。
226
+ - **Nightly**(`.github/workflows/nightly.yml`):每天定时跑全量套件与同样的慢闸门,
227
+ 让只在发布时才跑的东西每天都被看见。
228
+ - **通用门禁框架**:配置驱动的 gate 清单、`strict` / `loose` 策略、行内豁免、
229
+ 台账与链式校验;`run_gate.py` / `auto-gate.py` / `cli.py` / MCP 四个入口;
230
+ 附 3 条示例规则(`NO-CONSOLE` / `NO-HARDIP` / `EOL-UNIFIED`)。
231
+
232
+ ### Changed
233
+
234
+ - 共享配置只声明仓库键名;各仓库在本机的路径放在 git 忽略的本地覆盖层。
235
+ - 测试套件按文件并行执行,提供 `--fast`(编辑回路)与 `--full`(提交 / CI)两档。
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 AgentGuard
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,23 @@
1
+ # sdist 必须带上引擎 —— wheel 由 setup.py 的 build_py 从这里复制进 guardrail_engine/_engine/。
2
+ # 漏掉任何一棵子树,`pip install <sdist>` 都会产出"没有引擎的 wheel"(§5.2 的形状)。
3
+ include VERSION
4
+ include LICENSE
5
+ include README.md
6
+ include README.en.md
7
+ include AGENTS.md
8
+ include CHANGELOG.md
9
+
10
+ recursive-include checks *.py
11
+ recursive-include harness *
12
+ recursive-include config *.toml *.yaml
13
+ recursive-include sandbox *.py *.sh *.txt
14
+ recursive-include golden-patterns *
15
+ recursive-include integrations *
16
+ recursive-include docs *
17
+
18
+ # 本机事实与缓存绝不进包
19
+ exclude config/harness.local.toml
20
+ exclude config/harness.local.yaml
21
+ global-exclude __pycache__
22
+ global-exclude *.py[co]
23
+ global-exclude .DS_Store