@lmzhen/dsh-evolution-threat 0.3.33 → 0.3.35

package/README.md

@@ -18,6 +18,15 @@ Zero direct token effect from this package; consumers add any model-visible toke
 
 Independent of request-prefix construction. This package does not alter the assembled prompt or tool list.
 
+## Config
+
+- `maxScanChars` (default 65536): the scan window size in normalized characters.
+  Legal range is `>= 4097` — a smaller window cannot guarantee full-coverage
+  scanning (the overlap floor is `PATTERN_OVERLAP + 1` in evolution-core), so
+  the schema rejects it at load and the assembly clamp falls back to the
+  default. The whole text is always scanned in overlapping windows; this value
+  is not a total cap.
+
 ## Known Limitations and Deferred Work
 
 

package/lib/index.js

@@ -1,5 +1,5 @@
 import z from "@deepseek-ai/schemastery";
-import { EVOLUTION_WRITE_TOOLS, clampedNumber, scanContentThreats, scanMemoryThreats } from "@lmzhen/dsh-evolution-core";
+import { EVOLUTION_WRITE_TOOLS, PATTERN_OVERLAP, clampedNumber, scanContentThreats, scanMemoryThreats } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Write-time threat guard for evolution tools.
@@ -9,7 +9,7 @@ const name = "evolution-threat";
 const inject = ["tools"];
 const Config = z.object({
 	enabled: z.boolean().default(true),
-	maxScanChars: z.number().min(1).default(65536)
+	maxScanChars: z.number().min(PATTERN_OVERLAP + 1).default(65536)
 });
 function asRecord(value) {
 	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
@@ -44,10 +44,12 @@ function scanToolArgs(toolName, args, maxScanChars) {
 	return null;
 }
 /** Resolve the effective `maxScanChars`, clamping invalid values to the
-* default (G3.1: 0/negative/NaN/±Infinity → 65_536). Exported so the clamp is
-* directly testable; `apply` warns when a user-supplied value was corrected. */
+* default (G3.1: 0/negative/NaN/±Infinity → 65_536; V6-05: a value below
+* PATTERN_OVERLAP + 1 is out of the coverage-guarantee domain → default).
+* Exported so the clamp is directly testable; `apply` warns when a
+* user-supplied value was corrected. */
 function resolveMaxScanChars(config) {
-	return clampedNumber(config.maxScanChars ?? 65536, 65536, { min: 1 });
+	return clampedNumber(config.maxScanChars ?? 65536, 65536, { min: PATTERN_OVERLAP + 1 });
 }
 function apply(ctx, rawConfig = {}) {
 	if (!(rawConfig.enabled ?? true)) return;

package/lib/types/index.d.ts

@@ -16,8 +16,10 @@ export declare const Config: z<Config>;
  * guard contract is testable directly (0.3.17). */
 export declare function scanToolArgs(toolName: string, args: unknown, maxScanChars: number): string | null;
 /** Resolve the effective `maxScanChars`, clamping invalid values to the
- * default (G3.1: 0/negative/NaN/±Infinity → 65_536). Exported so the clamp is
- * directly testable; `apply` warns when a user-supplied value was corrected. */
+ * default (G3.1: 0/negative/NaN/±Infinity → 65_536; V6-05: a value below
+ * PATTERN_OVERLAP + 1 is out of the coverage-guarantee domain → default).
+ * Exported so the clamp is directly testable; `apply` warns when a
+ * user-supplied value was corrected. */
 export declare function resolveMaxScanChars(config: Config): number;
 export declare function apply(ctx: Context, rawConfig?: Config): void;
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-threat",
   "description": "Write-time threat guard for evolution tools (community build)",
-  "version": "0.3.33",
+  "version": "0.3.35",
   "publishConfig": {
     "access": "public"
   },
@@ -31,7 +31,7 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.33"
+    "@lmzhen/dsh-evolution-core": "^0.3.35"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
@@ -42,6 +42,6 @@
     "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
-    "@lmzhen/dsh-evolution-core": "^0.3.33"
+    "@lmzhen/dsh-evolution-core": "^0.3.35"
   }
 }