blitzstrike 2.4.39 → 2.4.41

package/CHANGELOG.md

@@ -5,6 +5,30 @@ 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.41] — 2026-09-14
+
+### Added — Blind Differential Oracle (calibration-based sink detection)
+
+- New `src/blind-oracle.ts`: detect which sink a request parameter reaches
+  WITHOUT a malicious payload — calibration + differential. Arithmetic
+  identities (`id=1` vs `id=1+0`/`id=2-1`) reveal SQL/expression context; SSTI
+  arithmetic (`test${7*7}`) reveals template engines; a unique marker reveals
+  XSS reflection. Benign probes (numbers + operators), deterministic inference.
+- New `blind_oracle` tool: WAF-safe blind detection for sql/ssti/xss.
+
+## [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,262 @@ 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/blind-oracle.ts
+function arithmeticProbes(value) {
+  const n = Number(value);
+  if (Number.isNaN(n) || value.trim() === "")
+    return [];
+  return [
+    { sink: "sql_arithmetic", name: "plus_zero", payload: `${n}+0` },
+    { sink: "sql_arithmetic", name: "minus_zero", payload: `${n}-0` },
+    { sink: "sql_arithmetic", name: "times_one", payload: `${n}*1` },
+    { sink: "sql_coercion", name: "leading_zero", payload: `0${value}` },
+    { sink: "sql_coercion", name: "float_form", payload: `${n}.0` }
+  ];
+}
+function sstiProbes(value) {
+  return [
+    { sink: "ssti", name: "dollar_math", payload: `${value}\${7*7}` },
+    { sink: "ssti", name: "hash_math", payload: `${value}#{7*7}` },
+    { sink: "ssti", name: "mustache_math", payload: `${value}{{7*7}}` }
+  ];
+}
+function xssProbe(value, marker) {
+  return { sink: "xss", name: "marker", payload: `${value}${marker}` };
+}
+function classifyBlindProbe(input) {
+  const same = input.bodyHash === input.baselineHash;
+  let signal = false;
+  let reason = "";
+  if (input.sink === "sql_arithmetic" && same) {
+    signal = true;
+    reason = "arithmetic identity returned the SAME result as the bare value — the parameter is evaluated arithmetically (SQL/expression context).";
+  } else if (input.sink === "sql_coercion" && same) {
+    signal = true;
+    reason = "type-coerced variant returned the SAME result — the parameter is normalized numerically (SQL typed column).";
+  } else if (input.sink === "ssti" && !same && /49/.test(input.body)) {
+    signal = true;
+    reason = "the SSTI arithmetic (7*7) rendered as 49 in the response — the parameter reaches a template engine (SSTI).";
+  } else if (input.sink === "xss" && input.marker && input.body.includes(input.marker)) {
+    signal = true;
+    reason = "the unique marker was reflected in the response — the parameter reaches HTML output (reflected).";
+  }
+  return { same_as_baseline: same, signal, reason };
+}
+async function blindOracle(baseUrl, param, value, opts = {}) {
+  const base = baseUrl.replace(/\/+$/, "");
+  const sinks = opts.sinks ?? ["sql", "ssti", "xss"];
+  const marker = `zz${Math.random().toString(36).slice(2, 10)}zz`;
+  const headers = { "User-Agent": "Mozilla/5.0 (blitzstrike oracle probe)" };
+  const timeoutMs = opts.timeoutMs ?? 8000;
+  const build = (payload) => `${base}?${encodeURIComponent(param)}=${encodeURIComponent(payload)}`;
+  let baselineHash = "";
+  let baselineSize = 0;
+  let baselineStatus = 0;
+  try {
+    const r = await fetch(build(value), { headers, redirect: "manual", signal: AbortSignal.timeout(timeoutMs) });
+    baselineStatus = r.status;
+    const body = await r.text();
+    baselineHash = sha256(body);
+    baselineSize = body.length;
+  } catch (e) {
+    return { error: "baseline fetch failed", base_url: base, param, detail: String(e) };
+  }
+  const probes = [];
+  if (sinks.includes("sql"))
+    probes.push(...arithmeticProbes(value));
+  if (sinks.includes("ssti"))
+    probes.push(...sstiProbes(value));
+  if (sinks.includes("xss"))
+    probes.push(xssProbe(value, marker));
+  const results = [];
+  for (const p of probes) {
+    const t0 = Date.now();
+    try {
+      const r = await fetch(build(p.payload), { headers, redirect: "manual", signal: AbortSignal.timeout(timeoutMs) });
+      const timing = Date.now() - t0;
+      const status = r.status;
+      const body = await r.text();
+      const bodyHash = sha256(body);
+      const cls = classifyBlindProbe({
+        baselineHash,
+        baselineSize,
+        bodyHash,
+        size: body.length,
+        sink: p.sink,
+        name: p.name,
+        body,
+        marker
+      });
+      results.push({
+        sink: p.sink,
+        name: p.name,
+        payload: p.payload,
+        status,
+        size: body.length,
+        timing_ms: timing,
+        body_hash: bodyHash.slice(0, 12),
+        same_as_baseline: cls.same_as_baseline,
+        signal: cls.signal,
+        reason: cls.reason
+      });
+    } catch {
+      results.push({ sink: p.sink, name: p.name, payload: p.payload, status: 0, size: 0, timing_ms: 0, body_hash: "", same_as_baseline: false, signal: false, reason: "fetch error/timeout" });
+    }
+  }
+  const signals = results.filter((r) => r.signal === true);
+  return {
+    base_url: base,
+    param,
+    value,
+    baseline: { status: baselineStatus, size: baselineSize, body_hash: baselineHash.slice(0, 16) },
+    probes_tested: results.length,
+    signals_found: signals.length,
+    signals,
+    all: results,
+    interpretation: "A signal means the parameter reaches that sink (evidence: the differential). Verify live before reporting — the oracle is a detection hint, not proof."
+  };
+}
+
 // 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 +58611,35 @@ ${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("blind_oracle", {
+    title: "Blind differential oracle (calibration-based sink detection)",
+    description: "LIVE (black-box, WAF-safe): detect which sink a request parameter reaches WITHOUT a malicious payload — calibration + differential. Arithmetic identities (id=1 vs id=1+0 / id=2-1) reveal SQL/expression context; SSTI arithmetic (test${7*7}) reveals template engines; a unique marker reveals XSS reflection. Benign probes (numbers + operators, no quotes/commands), deterministic byte-level inference.",
+    inputSchema: {
+      base_url: string2().describe("Target base URL"),
+      param: string2().describe("Parameter name to probe (e.g. id)"),
+      value: string2().describe("Baseline value for the parameter (e.g. 1)"),
+      sinks: string2().optional().describe("JSON array of sinks to probe (default ['sql','ssti','xss'])")
+    }
+  }, async ({ base_url, param, value, sinks }) => {
+    let s;
+    try {
+      s = sinks ? JSON.parse(sinks) : undefined;
+    } catch {
+      return { content: [{ type: "text", text: JSON.stringify({ error: "invalid sinks JSON" }) }] };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(await blindOracle(base_url, param, value, { sinks: s })) }] };
+  });
   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.41",
   "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": {