blitzstrike 2.4.39 → 2.4.40

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to Blitz Strike are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [2.4.40] — 2026-09-14
+
+### Added — Web Cache Key Normalization Gap Fuzzer (live, black-box)
+
+- New `src/cache-gap.ts`: fuzz an endpoint's path-normalization + static-
+  extension variants (`.css`, `..;/`, `%2f`, `%00`, `;`, case, …) to detect
+  web-cache deception / poisoning — where a cache keys on a static-looking path
+  but the origin serves private content.
+- New `cache_gap` tool: fetch a baseline, compare body hash + cache headers per
+  variant, and flag only evidence-backed gaps (cache_deception / normalization_gap).
+- Pure helpers `generateCacheVariants` + `classifyCacheResponse` for deterministic,
+  testable detection logic.
+
 ## [2.4.39] — 2026-09-14
 
 ### Added — Patch Reversal (1-day weaponization engine)

package/dist/index.js

@@ -57367,6 +57367,145 @@ function functionBody2(code, name) {
   return code.slice(open);
 }
 
+// src/cache-gap.ts
+function generateCacheVariants(endpoint) {
+  const e = endpoint.startsWith("/") ? endpoint : "/" + endpoint;
+  const variants = new Set;
+  const add = (s) => variants.add(s);
+  const exts = [".css", ".js", ".png", ".jpg", ".jpeg", ".json", ".txt", ".ico", ".html", ".svg", ".woff", ".xml", ".gif"];
+  for (const ext of exts) {
+    add(`${e}${ext}`);
+    add(`${e}/${ext.slice(1)}`);
+    add(`${e}${ext}?x=1`);
+    add(`${e}${ext};`);
+    add(`${e}${ext}%3b`);
+  }
+  const suffix = [
+    "/style.css",
+    "/..;/style.css",
+    "/.;/style.css",
+    "/../style.css",
+    "/%2e%2e/style.css",
+    "/%2fstyle.css",
+    "/;style.css",
+    "/%3bstyle.css",
+    "/./style.css",
+    "//style.css",
+    "/%00.style.css",
+    "/style.css/.",
+    "/style.css%2f",
+    "/style.css%00",
+    "/style.css%2e%2e"
+  ];
+  for (const s of suffix)
+    add(`${e}${s}`);
+  add(e.replace(/^\//, "/%2f"));
+  add(e.replace(/^\//, "//"));
+  add(e.replace(/^\//, "/./"));
+  add(e.replace(/^\//, "/%2e/"));
+  add(e.replace(/^\//, "/..;/"));
+  add(`${e}%00`);
+  add(`${e};`);
+  add(`${e}%3b`);
+  add(`${e}?`);
+  add(`${e}?x=1`);
+  add(`${e}#`);
+  add(e.toUpperCase());
+  return [...variants].filter((v) => v !== e);
+}
+function classifyCacheResponse(input) {
+  const same = input.bodyHash === input.baselineHash;
+  const lower = Object.fromEntries(Object.entries(input.headers).map(([k, v]) => [k.toLowerCase(), v]));
+  const cacheStatus = lower["x-cache"] ?? lower["cf-cache-status"] ?? lower["x-served-by"] ?? lower["x-cache-status"] ?? null;
+  const cacheControl = lower["cache-control"] ?? "";
+  const age = lower["age"];
+  const cacheable = /public|max-age|s-maxage/.test(cacheControl) || age !== undefined || cacheStatus !== null && /hit/i.test(cacheStatus) || input.staticExtension;
+  if (same && input.staticExtension && cacheable) {
+    return {
+      same_body: true,
+      cacheable,
+      cache_status: cacheStatus,
+      gap: "cache_deception",
+      detail: "the endpoint's content is returned for a static-extension path that is cacheable — a cache may store PRIVATE content under a PUBLIC static key (cache deception)."
+    };
+  }
+  if (same && cacheStatus !== null && /hit/i.test(cacheStatus)) {
+    return {
+      same_body: true,
+      cacheable,
+      cache_status: cacheStatus,
+      gap: "cache_deception",
+      detail: `the endpoint's content is served from cache (${cacheStatus}) — the response is being cached and shared.`
+    };
+  }
+  if (!same && input.staticExtension && input.status !== 200) {
+    return {
+      same_body: false,
+      cacheable,
+      cache_status: cacheStatus,
+      gap: "normalization_gap",
+      detail: "the static-extension variant resolves differently than the baseline (origin normalized the path) — cache key may diverge from the origin resource (normalization gap)."
+    };
+  }
+  return { same_body: same, cacheable, cache_status: cacheStatus, gap: null, detail: "" };
+}
+function headersToRecord(h) {
+  const out = {};
+  h.forEach((v, k) => {
+    out[k.toLowerCase()] = v;
+  });
+  return out;
+}
+function pickCacheHeaders(h) {
+  const keys = ["cache-control", "age", "expires", "x-cache", "cf-cache-status", "x-served-by", "x-cache-status", "via", "etag", "last-modified", "vary"];
+  const out = {};
+  for (const k of keys)
+    if (h[k] !== undefined)
+      out[k] = h[k];
+  return out;
+}
+async function cacheGapScan(baseUrl, endpoint, opts = {}) {
+  const base = baseUrl.replace(/\/+$/, "");
+  const endpointPath = endpoint.startsWith("/") ? endpoint : "/" + endpoint;
+  const variants = generateCacheVariants(endpointPath).slice(0, opts.maxVariants ?? 60);
+  const headers = { "User-Agent": "Mozilla/5.0 (blitzstrike cache probe)", Accept: "*/*" };
+  let baselineHash = "";
+  let baselineStatus = 0;
+  let baselineHeaders = {};
+  try {
+    const resp = await fetch(base + endpointPath, { headers, redirect: "manual", signal: AbortSignal.timeout(opts.timeoutMs ?? 8000) });
+    baselineStatus = resp.status;
+    baselineHeaders = headersToRecord(resp.headers);
+    baselineHash = sha256(await resp.text());
+  } catch (e) {
+    return { error: "baseline fetch failed", base_url: base, endpoint: endpointPath, detail: String(e) };
+  }
+  const results = [];
+  for (const v of variants) {
+    try {
+      const resp = await fetch(base + v, { headers, redirect: "manual", signal: AbortSignal.timeout(opts.timeoutMs ?? 8000) });
+      const status = resp.status;
+      const hdrs = headersToRecord(resp.headers);
+      const bodyHash = sha256(await resp.text());
+      const staticExtension = /\.(css|js|png|jpe?g|json|txt|ico|html|svg|woff|xml|gif)([;?].*)?$/i.test(v);
+      const cls = classifyCacheResponse({ baselineHash, bodyHash, status, headers: hdrs, staticExtension });
+      results.push({ path: v, status, same_body: cls.same_body, cacheable: cls.cacheable, cache_status: cls.cache_status, gap: cls.gap, detail: cls.detail });
+    } catch {
+      results.push({ path: v, status: 0, same_body: false, cacheable: false, cache_status: null, gap: null, detail: "fetch error/timeout" });
+    }
+  }
+  const gaps = results.filter((r) => r.gap !== null);
+  return {
+    base_url: base,
+    endpoint: endpointPath,
+    baseline: { status: baselineStatus, body_hash: baselineHash.slice(0, 16), cache_headers: pickCacheHeaders(baselineHeaders) },
+    variants_tested: results.length,
+    gaps_found: gaps.length,
+    gaps,
+    all: results
+  };
+}
+
 // src/enterprise-benchmark.ts
 import { existsSync as existsSync11, readFileSync as readFileSync20, readdirSync as readdirSync6, statSync as statSync3 } from "node:fs";
 import { join as join18, resolve } from "node:path";
@@ -58355,6 +58494,17 @@ ${statusLine}` : statusLine },
       return { content: [{ type: "text", text: JSON.stringify({ error: "provide code or path" }) }] };
     return { content: [{ type: "text", text: JSON.stringify(actionSurface(src)) }] };
   });
+  server.registerTool("cache_gap", {
+    title: "Web cache key normalization gap fuzzer",
+    description: "LIVE (black-box, no source code): fuzz an endpoint's path-normalization + static-extension variants to detect web-cache deception / poisoning — where a cache keys on a static-looking path but the origin serves private content. Deterministic + evidence-first: fetch a baseline, then compare body hash + cache headers per variant. High-impact class (cached private data, mass takeover) that is still under-hunted.",
+    inputSchema: {
+      base_url: string2().describe("Target base URL (e.g. https://target.com)"),
+      endpoint: string2().describe("Endpoint path to probe (e.g. /account or /profile)"),
+      max_variants: number2().optional().describe("Max variants to test (default 60)")
+    }
+  }, async ({ base_url, endpoint, max_variants }) => {
+    return { content: [{ type: "text", text: JSON.stringify(await cacheGapScan(base_url, endpoint, { maxVariants: max_variants })) }] };
+  });
   server.registerTool("payload_lookup", {
     title: "Look up exploit payloads",
     description: "INTEL: find a payload collection (66 categories from PayloadsAllTheThings).",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blitzstrike",
-  "version": "2.4.39",
+  "version": "2.4.40",
   "description": "Blitz Strike — a universal MCP security-audit toolbelt. BLITZ sweeps the attack surface, EAGLE-EYE traces source-to-sink, STRIKE verifies live. 57 attack chains, 130-tool catalog, intelligence data layer. One server, every agent.",
   "type": "module",
   "bin": {