@cobusgreyling/loop-gate

中文文档
1.0.0发布于 2026/07/20MITTypeScriptES Module构建来源已验证近 30 天下载 2378

机械执行LOOP.md/docs/security.md的路径否定列表和自动合并许可列表——对照静态政策评价拟议修改,并屏蔽或允许.

中文使用文档
文档目录4 节
  1. 安装运行( R)
  2. 使用量
  3. 政策文件
  4. 这不起作用

循环门

静态安全政策的机械执行——后面的守则 docs/safety.md路径拒绝列表和自动元政策,以及 LOOP.md是因为 "除了无关紧要的依赖补丁之外 不要在主上自动出现" 编号 : "没有人类评论的" 规则。 之前没有评估过拟议改变该信条的情况; loop-gate 已经.

故意的 已经 对运行历史一无所知. 停滞、一再失败和象征性/每日预算已经属于 loop-context断路器 - loop-gate 仅看 什麽 正在提出(路径、行动类型),而不是 跑步表现如何将两者联系起来:

loop-context --check --ledger run.json ...            || exit 2   # run-history based
loop-gate check --action auto-merge --paths a.ts,b.ts  || exit 2   # policy based
do-the-merge

安装运行( R)

npx @cobusgreyling/loop-gate check --action auto-merge --paths docs/guide.md

从此 repo:

cd tools/loop-gate
npm install
npm test

使用量

loop-gate check --action <commit|merge|auto-merge> --paths <f1,f2,...> [--gate-file gate.yaml] [--json]
旗帜默认含义
--action <commit|merge|auto-merge>所需经费循环要做什么
--paths <f1,f2,...>所需经费逗号分隔已更改的文件路径
--gate-file <path>gate.yaml (中文(简体) )对照评价的政策文件
--json关机器可读的决定输出

退出代码 : 0 允许 2 * 升级 1 错误( 坏旗, 缺少/ 无效配置) .

政策文件

gate.yaml 是机器可读的双相 docs/safety.md 看到了吗 templates/gate.yaml.template 要脚手架自己的, 或者这个雷波自己的狗食品 gate.yaml数字 :

version: 1
denylist:
  - ".env"
  - "**/secrets/**"
  - "auth/**"
maxFiles: 10
autoMergeAllowlist:
  - "docs/**"
  - "**/*.md"

检查顺序( 第一局胜出, 相同“ 最具体的触发器优先” 常规 loop-context断路器用途 :

  1. denylist —— 任何与这里的光彩相匹配的已改变路径都会升级, 不管 --action。 。 。 .
  2. maxFiles —— 改变的路径比这个升级( 匹配) docs/safety.md'" "Changes touching >N files"人行门".
  3. autoMergeAllowlist - 仅在检查时 --action auto-merge;每个被改变的路径必须匹配其中的一条光泽,否则会升级.

Glob 匹配通过 minimatch (相同的语义) .gitignore- 风格的花纹使用 - ** 横跨路径段匹配 .

这不起作用

  • 不读一个运行分类账, 永远不会—— 保持它与 loop-context 在源一级,同样的方式 loop-worktree 财务报告和审定财务报表 loop-context 保持独立,同时仍以控制脚本按常规配对.
  • 不产生自己的升级摘要格式, 将 JSON 的决定折叠成您已经组装的控制脚本 loop-context --inject 当升入人类.
  • 本身不执行任何措施——如 loop-worktree锁,这是建议:一个跳过调用的控制脚本 loop-gate 没有被物理封锁。 机能仅能与所取名的脚本一样好.

见 文件/安全数据 用于编纂政策,以及 文件/原始资料 安全门适合五层楼 + 记忆模型.

版本与发布记录

@cobusgreyling/loop-gate 共发布 1 个版本,首次发布于 2026/07/20;过去 12 个月发布了 1 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.0.0latest2026/07/203 个月前

关于 @cobusgreyling/loop-gate 的常见问题

@cobusgreyling/loop-gate 是什么?

机械执行LOOP.md/docs/security.md的路径否定列表和自动合并许可列表——对照静态政策评价拟议修改,并屏蔽或允许.

如何安装 @cobusgreyling/loop-gate?

在项目目录运行 npm install @cobusgreyling/loop-gate,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 loop-gate,可以用 npx loop-gate 直接运行。

@cobusgreyling/loop-gate 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@cobusgreyling/loop-gate 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@cobusgreyling/loop-gate 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@cobusgreyling/loop-gate 可以商用吗?

@cobusgreyling/loop-gate 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@cobusgreyling/loop-gate 的下载量有多少?

根据 npm 官方下载统计,@cobusgreyling/loop-gate 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,378 次,日均约 79 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cobusgreyling/loop-gate 还在维护吗?

最新版本 1.0.0 发布于 2026/07/20(3 个月前);至今共发布 1 个版本,其中过去 12 个月发布了 1 个;首次发布于 2026/07/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。