peaks-loop 4.0.40 → 4.0.41

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 4.0.41 — 2026-09-11 (闸门指导不再鼓励"每次编辑前念一遍")
+
+**Highlights**:
+
+1. **4.0.40 的措辞修好了"误读",但没修"频率" —— 这一版修频率。** 用户在 Mac 上继续工作时反馈:闸门仍然频繁打断。查下去发现**真正被烧掉的时间不是拒绝本身,而是一个仪式** —— 被告诉"预期每个文件被拦一次"之后,模型很自然地选择**预防**:在每次编辑前先把那四条事实念一遍,好让拒绝根本不出现。用户日志里那些重复的 `[Fact-Force Gate] 1..4` 块**是模型自己的话,不是闸门的输出**(闸门自称 `Fact-Forcing`,列的问题也不同)。每次编辑多一次「思考 10 秒 + 复述」,累起来就是他看到的 5 分钟。
+
+   - 现在指导明确要求:**不要预防性复述,闸门问的时候再答。** 拒绝是减速带,不是飞行前检查单。
+
+2. **顺带记录了一条会读成"我退步了"的闸门行为。** 闲置约 30 分钟后,钩子会**删掉自己的状态文件**(`SESSION_TIMEOUT_MS`),清空"已通过"清单 —— 于是**之前已经放行的文件会再次被拦**。不知情的话,这读起来像模型又犯了错。指导里现在写明了:那是闸门在重置,不是你在退步。
+
+3. **同时记下三个可用的旋钮**(闸门自带,非 peaks 引入):`GATEGUARD_EXEMPT_GLOBS`(逗号分隔 glob,加进去的路径直接豁免 —— peaks 写入时**取并集**,不会覆盖你写的)、`GATEGUARD_FACT_FORCE_FULL_DENIALS`(拒绝预算)、`GATEGUARD_DISABLED=1`(整个关掉)。**测试目录这类"没什么事实可建立"的路径,加一条 glob 就不再拦**。
+
+**验证**:三个版本常量一致(4.0.41);`tsc -p tsconfig.build.json` exit 0;宽 `tsconfig.json` 保持 **142** 基线;`tests/unit` **188 files / 1794 passed / 3 skipped / 0 failed**。
+
 ## 4.0.40 — 2026-09-11 (两条被 4.0.39 暴露出来的既有缺陷)
 
 **Highlights**:

package/README-en.md

@@ -140,7 +140,7 @@ Every lane opens with **one slash command**.
 
 | | |
 | --- | --- |
-| **Latest** | [![npm](https://img.shields.io/npm/v/peaks-loop?style=for-the-badge&logo=npm&logoColor=white&color=cb3837)](https://www.npmjs.com/package/peaks-loop) — 4.0.40 (2026-09-11) |
+| **Latest** | [![npm](https://img.shields.io/npm/v/peaks-loop?style=for-the-badge&logo=npm&logoColor=white&color=cb3837)](https://www.npmjs.com/package/peaks-loop) — 4.0.41 (2026-09-11) |
 | **Domains** | Code (`peaks-code`) · Content (`peaks-content`) · Project health (`peaks-doctor`) · Issue sweep (`peaks-issue-fix-orchestrator`) · Custom SOP (`peaks-sop`) · Cross-domain primitives (`peaks-solo` dispatcher · `peaks-resume` · `peaks-status` · `peaks-test` · `peaks-slice-decompose`) |
 | **Sediment pool** | `~/.peaks/` local pool · twice-clean runs auto-promote to a bee · broken runs come back for you to redefine · the bee grows with your taste |
 | **Test suite** | 285+ cases · 4 packages (peaks-loop / peaks-loop-mut / peaks-loop-shared-channel / peaks-loop-shared) · **0 timeouts** · 14 BDD caller-binding edge cases |

package/README.md

@@ -140,7 +140,7 @@ npm i -g peaks-loop
 
 | | |
 | --- | --- |
-| **最新版本** | [![npm](https://img.shields.io/npm/v/peaks-loop?style=for-the-badge&logo=npm&logoColor=white&color=cb3837)](https://www.npmjs.com/package/peaks-loop) — 4.0.40(2026-09-11) |
+| **最新版本** | [![npm](https://img.shields.io/npm/v/peaks-loop?style=for-the-badge&logo=npm&logoColor=white&color=cb3837)](https://www.npmjs.com/package/peaks-loop) — 4.0.41(2026-09-11) |
 | **覆盖域** | 代码(`peaks-code`) · 内容(`peaks-content`) · 项目健康(`peaks-doctor`) · 批量修 issue(`peaks-issue-fix-orchestrator`) · 自定义 SOP(`peaks-sop`) · 通用原语(`peaks-solo` 分诊 / `peaks-resume` 续 / `peaks-status` 看 / `peaks-test` 测 / `peaks-slice-decompose` 切片) |
 | **沉淀池** | `~/.peaks/` 本地池 · 跑两次自动晋升成 bee · 跑翻车让你重定义 · bee 跟着你的口味长 |
 | **测试套件** | 1096 cases · 4 packages (peaks-loop 1015 / runtime 39 / mut 22 / shared-channel 20) · **CI 首次全绿**(ubuntu + windows) · 14 BDD caller-binding coverage |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peaks-loop",
-  "version": "4.0.40",
+  "version": "4.0.41",
   "description": "Loop Engineering CLI — workflow primitive / loop guards / evaluators / slice orchestration",
   "author": "SquabbyZ",
   "keywords": [
@@ -101,10 +101,10 @@
     "fzf": "^0.5.2",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "peaks-loop-internal-runtime": "0.0.25",
-    "peaks-loop-shared": "0.0.74",
-    "peaks-loop-shared-channel": "0.0.42",
-    "peaks-loop-mut": "0.1.38"
+    "peaks-loop-internal-runtime": "0.0.26",
+    "peaks-loop-shared-channel": "0.0.43",
+    "peaks-loop-mut": "0.1.39",
+    "peaks-loop-shared": "0.0.75"
   },
   "devDependencies": {
     "@changesets/cli": "2.31.1",

package/skills/bee/peaks-perf-audit/SKILL.md

@@ -31,13 +31,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 # peaks-perf-audit

package/skills/bee/peaks-prd/SKILL.md

@@ -27,13 +27,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 ---
 

package/skills/bee/peaks-qa/SKILL.md

@@ -27,13 +27,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 ---
 

package/skills/bee/peaks-rd/SKILL.md

@@ -28,13 +28,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 ---
 

package/skills/bee/peaks-reviewer/SKILL.md

@@ -23,13 +23,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 ## Single-scope-axis naming convention

package/skills/bee/peaks-sc/SKILL.md

@@ -27,13 +27,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 ---
 

package/skills/bee/peaks-security-audit/SKILL.md

@@ -31,13 +31,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 # peaks-security-audit

package/skills/bee/peaks-txt/SKILL.md

@@ -27,13 +27,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 ---
 

package/skills/bee/peaks-ui/SKILL.md

@@ -27,13 +27,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 ---
 

package/skills/peaks-audit/SKILL.md

@@ -22,13 +22,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 ## Single-scope-axis naming convention

package/skills/peaks-code/SKILL.md

@@ -22,13 +22,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 > **Detached sub-agent mode (Phase A, slice 2026-08-10).** When the orchestrator requires true parallelism with isolated context windows and survives orchestrator session exit, dispatch sub-agents with `--mode detached --vendor <claude|codex|copilot>`. The CLI spawns a real OS process via `ProcessSupervisor` (Windows `DETACHED_PROCESS` + `CREATE_NEW_PROCESS_GROUP`, POSIX `setsid` + `nohup`); the child vendor LLM receives a 5–8KB minimum prompt slice (no orchestrator session history) and self-compacts at 0.85 / 0.95 against the vendor window via the `<peaks-auto-compact>` marker (G8 — unlimited spend authorized). Orchestrator MUST emit one line of prose before every detached dispatch: `⏳ Spawning detached sub-agent via <vendor>: rid=<rid> (ETA ~60s)`. Status is read from `.peaks/_runtime/<sid>/detached/<rid>/status.json`; `LifecycleOwner` enforces 100% cleanup of `pid` / `log.txt` / `status.json` / `owner-session` on every exit path. `--no-throttle --max-concurrent <N>` bypasses `ResourceBudgetGuard` (user accepts risk; default max=8). See `references/sub-agent-dispatch.md` §"Detached Mode" for the full contract. Default mode remains `in-process` for backward compat (existing 106+ dispatch tests untouched).

package/skills/peaks-content/SKILL.md

@@ -22,13 +22,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 # peaks-content

package/skills/peaks-doctor/SKILL.md

@@ -23,13 +23,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 ---
 

package/skills/peaks-final-review/SKILL.md

@@ -22,13 +22,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 ## Single-scope-axis naming convention

package/skills/peaks-ide/SKILL.md

@@ -23,13 +23,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 ---
 

package/skills/peaks-issue-fix-orchestrator/SKILL.md

@@ -22,13 +22,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 # peaks-issue-fix-orchestrator

package/skills/peaks-resume/SKILL.md

@@ -22,13 +22,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 # Peaks-Loop Code Resume (wrapper)

package/skills/peaks-slice-decompose/SKILL.md

@@ -22,13 +22,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 ## Single-scope-axis naming convention

package/skills/peaks-solo/SKILL.md

@@ -33,13 +33,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 # peaks-solo — Dispatcher (分诊员)

package/skills/peaks-sop/SKILL.md

@@ -22,13 +22,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 # Peaks-Loop SOP Authoring

package/skills/peaks-status/SKILL.md

@@ -22,13 +22,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 # Peaks-Loop Code Status (wrapper)

package/skills/peaks-test/SKILL.md

@@ -22,13 +22,19 @@ mode** — standard *and* 24h. The mode moves the threshold, never the obligatio
 it — the normal way to work here — for every path outside `.peaks/**` (source, tests, docs,
 config); `.peaks/**` writes are exempt.
 
-**Expect one denial per file regardless.** A `PreToolUse` gate (ECC's "Fact-Forcing Gate")
-denies the FIRST edit a session makes to any given path, once, by design. Reading does NOT
-prevent it — the gate keys on the path's first touch, not on whether you read it. **A denial
-is not a failure and the tool is not broken — your edit was NOT applied.** State the facts it
-asks for (importers, affected API, data schemas if any, the user's verbatim instruction) and
-retry the SAME operation; the retry is allowed. Do not switch tools, do not give up, do not
-retry blindly.
+**Expect one denial per file anyway — and do NOT pre-empt it.** A `PreToolUse` gate (ECC's
+"Fact-Forcing Gate") denies the FIRST edit a session makes to any given path, once, by
+design. Reading does NOT prevent it: the gate keys on the path's first touch, not on whether
+you read it. **Do not recite its four questions before every edit** — it asks when it wants
+them, and reciting unprompted burns a round-trip per file for nothing. Answer only when a
+denial actually arrives.
+
+**When one does arrive:** a denial is not a failure and the tool is not broken — your edit
+was NOT applied. State the facts it asks for (importers, affected API, data schemas if any,
+the user's verbatim instruction), then retry the SAME operation. The retry is allowed. Do not
+switch tools, do not give up, do not retry blindly. One more thing worth knowing: an idle gap
+of ~30 minutes clears the gate's "already passed" list, so a file you cleared earlier can be
+denied again after a long pause. That is the gate resetting, not you regressing.
 <!-- /peaks:loop-hygiene -->
 
 # Peaks-Loop Code Test (wrapper)