From 21fd44aa19ef4338c1c8ea5aba4d2169e6ad16a4 Mon Sep 17 00:00:00 2001
From: Brennan Benson <79079362+brennanb2025@users.noreply.github.com>
Date: Tue, 28 Jul 2026 18:14:00 -0700
Subject: [PATCH] docs(skills): state the declared-root guard's real window in
 the bounds comment

---
 src/main/skills/skill-plugin-cache-scan.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/skills/skill-plugin-cache-scan.ts b/src/main/skills/skill-plugin-cache-scan.ts
index 19d3981ba86..f3f37bc54e2 100644
--- a/src/main/skills/skill-plugin-cache-scan.ts
+++ b/src/main/skills/skill-plugin-cache-scan.ts
@@ -51,7 +51,7 @@ function errorCode(error: unknown): string | null {
 
 // Why: overriding a bound is how its truncation path stays executable — reaching the real
 // entry budget costs a 16k-dirent fixture per case, and the declared-root guard below it
-// only fires when the count lands in a one-entry window. Production passes neither.
+// needs the running count parked just under that budget. Production passes neither.
 export type PluginSkillScanBounds = {
   maximumCandidates?: number
   maximumEntries?: number