circle-ir 3.182.0 → 3.185.0

package/dist/browser/circle-ir.js

@@ -11326,6 +11326,49 @@ var DEFAULT_SOURCES = [
   // Server-side interceptor receives `Metadata headers`; `headers.get(KEY)`
   // returns caller-supplied header values.
   { method: "get", class: "Metadata", type: "http_header", severity: "high", return_tainted: true, languages: ["java"] },
+  // --- WebSocket transport channels (cognium-dev #213 second slice) ---
+  //
+  // Server-side WebSocket handlers receive attacker-authored frames on
+  // every call to a receive-shaped method. Untrusted the moment they
+  // return, regardless of any application-level auth on the socket.
+  //
+  // Python — FastAPI / Starlette (`from fastapi import WebSocket`):
+  //   data = await websocket.receive_text()
+  //   data = await websocket.receive_bytes()
+  //   data = await websocket.receive_json()   # parsed dict/list
+  //   data = await websocket.receive()        # {'type', 'text'|'bytes'}
+  { method: "receive_text", class: "WebSocket", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_bytes", class: "WebSocket", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_json", class: "WebSocket", type: "http_body", severity: "high", return_tainted: true, languages: ["python"] },
+  //
+  // `receive` intentionally class-scoped to WebSocket (Starlette pattern).
+  // Broadening to unqualified would collide with queue/signal `.receive()`.
+  { method: "receive", class: "WebSocket", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  // Django Channels `AsyncJsonWebsocketConsumer` / `WebsocketConsumer`
+  // expose the same receive_* names on `self`; the class filter matches
+  // `WebSocket` only, so add unqualified fallbacks for the receive_json /
+  // receive_text convention (broad — no class filter possible without
+  // hardcoding Django's consumer names).
+  { method: "receive_json", type: "http_body", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_text", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_bytes", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  // Go — gorilla/websocket (`github.com/gorilla/websocket`):
+  //   messageType, message, err := conn.ReadMessage()
+  //   _, r, err := conn.NextReader()
+  { method: "ReadMessage", class: "Conn", type: "network_input", severity: "high", return_tainted: true, languages: ["go"] },
+  { method: "NextReader", class: "Conn", type: "network_input", severity: "high", return_tainted: true, languages: ["go"] },
+  // nhooyr.io/websocket exposes a `Read` method on `*websocket.Conn`;
+  // signature is `func (c *Conn) Read(ctx) (MessageType, []byte, error)`.
+  { method: "Read", class: "Conn", type: "network_input", severity: "high", return_tainted: true, languages: ["go"] },
+  // Java — Jakarta / Java WebSocket API (`javax.websocket` / `jakarta.websocket`):
+  //   session.getBasicRemote().sendText(input);      // OUT (not a source)
+  //   @OnMessage public void onMessage(String msg) — `msg` is a callback
+  //   param, not a return; handled via param_tainted when annotation is set.
+  { annotation: "OnMessage", type: "network_input", severity: "high", param_tainted: true, languages: ["java"] },
+  // Spring `@MessageMapping` STOMP-over-WebSocket handlers receive
+  // untrusted payloads on every dispatched frame.
+  { annotation: "MessageMapping", type: "http_body", severity: "high", param_tainted: true, languages: ["java"] },
+  { annotation: "SubscribeMapping", type: "http_body", severity: "high", param_tainted: true, languages: ["java"] },
   // --- Cache reads (second-order taint — Redis / Memcached / Django cache) ---
   // The cache round-trip is a canonical second-order sink: whatever was
   // written previously (potentially attacker-controlled) resurfaces on read.
@@ -13398,6 +13441,60 @@ var DEFAULT_SANITIZERS = [
   // Python Type coercion
   { method: "int", removes: ["sql_injection", "command_injection", "xss"] },
   { method: "float", removes: ["sql_injection", "command_injection"] },
+  // Python URL encoding (cognium-dev #213 fifth slice).
+  //
+  //   urllib.parse.quote(x)      — RFC-3986 percent-encode; safe for URL path
+  //   urllib.parse.quote_plus(x) — same + space→+; safe for query string
+  //   urllib.parse.urlencode(d)  — encode a dict of pairs
+  //
+  // Bounded to URL-context sinks. Class-scoped to the specific
+  // `urllib.parse` receiver to avoid colliding with unrelated bare
+  // `quote(...)` calls in other libraries.
+  { method: "quote", class: "urllib.parse", removes: ["ssrf", "open_redirect", "xss", "path_traversal"] },
+  { method: "quote_plus", class: "urllib.parse", removes: ["ssrf", "open_redirect", "xss", "path_traversal"] },
+  { method: "urlencode", class: "urllib.parse", removes: ["ssrf", "open_redirect", "xss"] },
+  // Bare aliases — `from urllib.parse import quote` then unqualified.
+  { method: "quote_plus", removes: ["ssrf", "open_redirect", "xss", "path_traversal"] },
+  { method: "urlencode", removes: ["ssrf", "open_redirect", "xss"] },
+  // `quote` bare is intentionally NOT registered — it collides with
+  // shlex.quote (bare-imported) which is a command_injection sanitizer,
+  // not a URL sanitizer. The class-scoped variant above catches the
+  // qualified `urllib.parse.quote(...)` shape; unqualified callers who
+  // want URL-context credit should use `quote_plus` (which does not
+  // collide with any command_injection sanitizer).
+  // Python XSS — additional common sanitizers.
+  //
+  //   bleach.clean(...)   — already covered above (line 2898)
+  //   bleach.linkify(...) — turns URLs into anchor tags; sanitizes as well
+  //   django.utils.html.escape / strip_tags — Django's XSS escape helpers
+  //   jinja2.escape       — Jinja2's Markup escape (aliased from markupsafe)
+  //   flask.escape        — Flask re-export of markupsafe.escape
+  //   saxutils.escape     — stdlib xml.sax.saxutils.escape for XML docs
+  { method: "linkify", class: "bleach", removes: ["xss"] },
+  // Bare `linkify(...)` alias — `from bleach import linkify`.
+  { method: "linkify", removes: ["xss"] },
+  { method: "escape", class: "django.utils.html", removes: ["xss"] },
+  { method: "strip_tags", class: "django.utils.html", removes: ["xss"] },
+  { method: "escape", class: "jinja2", removes: ["xss"] },
+  { method: "escape", class: "flask", removes: ["xss"] },
+  { method: "escape", class: "saxutils", removes: ["xss"] },
+  { method: "escape", class: "xml.sax.saxutils", removes: ["xss"] },
+  { method: "quoteattr", class: "saxutils", removes: ["xss"] },
+  { method: "quoteattr", class: "xml.sax.saxutils", removes: ["xss"] },
+  // Python ReDoS — `re.escape(user)` when building a regex from user input
+  // strips regex metacharacters. Downstream `re.compile / re.match` cannot
+  // interpret user-supplied alternations or quantifiers. Also covers the
+  // `code_injection` categorization that `re.compile` currently emits
+  // (a re.escape-wrapped pattern cannot execute anything, so both are safe).
+  { method: "escape", class: "re", removes: ["redos", "code_injection"] },
+  // Python SQLAlchemy — `text(...).bindparams(...)` binds params safely.
+  // The `bindparams` call is the sanitizer; the parent `text` wraps the
+  // template. Also add `expression.literal` for explicit SQL literals.
+  { method: "bindparams", removes: ["sql_injection"] },
+  // psycopg2 sql-composition helpers
+  { method: "Identifier", class: "sql", removes: ["sql_injection"] },
+  { method: "Literal", class: "sql", removes: ["sql_injection"] },
+  { method: "Placeholder", class: "sql", removes: ["sql_injection"] },
   // =========================================================================
   // Rust Sanitizers
   // =========================================================================
@@ -15321,7 +15418,14 @@ function matchesSanitizerPattern(call, pattern) {
       return false;
     }
     if (pattern.class) {
-      if (!call.receiver || !receiverMightBeClass(call.receiver, pattern.class)) {
+      if (!call.receiver) {
+        const target = call.resolution?.target;
+        const expectedTail = `${pattern.class}.${pattern.method}`;
+        if (target && (target === expectedTail || target.endsWith("." + expectedTail))) {
+        } else {
+          return false;
+        }
+      } else if (!receiverMightBeClass(call.receiver, pattern.class)) {
         return false;
       }
     }
@@ -25647,7 +25751,22 @@ var PYTHON_TAINTED_PATTERNS2 = [
   // configs/sources/python.json but was not in the forward-taint regex
   // registry, so `name = input()` was not added to pyTaintedVars. Closes
   // the deferred `getattr(obj, input())()` reflection-invocation shape.
-  { pattern: /\binput\s*\(/, type: "io_input" }
+  { pattern: /\binput\s*\(/, type: "io_input" },
+  // WebSocket transport channels (cognium-dev #213 second slice).
+  // FastAPI / Starlette (`from fastapi import WebSocket`) and Django
+  // Channels consumers both expose `receive_*` methods that return
+  // untrusted frame payloads on every call. Registered in
+  // config-loader.ts as return-tainted; the forward-taint regex here
+  // enables `data = await websocket.receive_text()` → `data` tainted,
+  // which the DFG-less Python path needs so downstream sinks that
+  // consume `data` are flagged.
+  //
+  // Deliberately not adding a bare `.receive\s*\(` here — that would
+  // match too many unrelated APIs (queue receive, signal receive, etc.)
+  // and produce spurious sources on every `x = q.receive()` in the wild.
+  { pattern: /\.receive_text\s*\(/, type: "network_input" },
+  { pattern: /\.receive_bytes\s*\(/, type: "network_input" },
+  { pattern: /\.receive_json\s*\(/, type: "http_body" }
 ];
 var LanguageSourcesPass = class {
   name = "language-sources";
@@ -26339,6 +26458,31 @@ function findJavaScriptAssignmentSources(sourceCode, language) {
       }
     }
   }
+  sources.push(...findJavaScriptCallbackParamSources(sourceCode));
+  return sources;
+}
+function findJavaScriptCallbackParamSources(sourceCode) {
+  const sources = [];
+  const CB_EVENT_RE = /\.on\s*\(\s*['"](?:message|text|binary)['"]\s*,\s*(?:async\s+)?(?:function\s*\*?\s*(?:\w+\s*)?\(\s*(\w+)|\(\s*(\w+)\s*(?:[,):]|$)|(\w+)\s*=>)/;
+  const lines = sourceCode.split("\n");
+  for (let i2 = 0; i2 < lines.length; i2++) {
+    const line = lines[i2];
+    const trimmed = line.trimStart();
+    if (trimmed.startsWith("//") || trimmed.startsWith("*")) continue;
+    const m = line.match(CB_EVENT_RE);
+    if (!m) continue;
+    const paramName = m[1] ?? m[2] ?? m[3];
+    if (!paramName) continue;
+    if (paramName === "err" || paramName === "error") continue;
+    sources.push({
+      type: "network_input",
+      location: `WebSocket .on(...) callback param '${paramName}' at line ${i2 + 1}`,
+      severity: "high",
+      line: i2 + 1,
+      confidence: 0.95,
+      variable: paramName
+    });
+  }
   return sources;
 }
 function findPythonAssignmentSources(sourceCode, language) {
@@ -26621,6 +26765,14 @@ function buildJavaScriptTaintedVars(sourceCode, language) {
   if (!["javascript", "typescript"].includes(language)) return /* @__PURE__ */ new Map();
   const tainted = /* @__PURE__ */ new Map();
   const lines = sourceCode.split("\n");
+  const CB_EVENT_RE = /\.on\s*\(\s*['"](?:message|text|binary)['"]\s*,\s*(?:async\s+)?(?:function\s*\*?\s*(?:\w+\s*)?\(\s*(\w+)|\(\s*(\w+)\s*(?:[,):]|$)|(\w+)\s*=>)/;
+  for (let i2 = 0; i2 < lines.length; i2++) {
+    const m = lines[i2].match(CB_EVENT_RE);
+    if (!m) continue;
+    const paramName = m[1] ?? m[2] ?? m[3];
+    if (!paramName || paramName === "err" || paramName === "error") continue;
+    tainted.set(paramName, i2 + 1);
+  }
   for (let i2 = 0; i2 < lines.length; i2++) {
     const line = lines[i2];
     const trimmed = line.trimStart();
@@ -26817,6 +26969,79 @@ function findBashTaintSources(sourceCode, dfg) {
         });
       }
     }
+    const readMatch = /^read\s*\(/.test(trimmed) ? null : trimmed.match(/^read\b([^#(]*)$/);
+    if (readMatch) {
+      const argStr = readMatch[1].trim();
+      const noRedirect = argStr.replace(/\s*<[^<].*$/, "").trim();
+      const tokens = noRedirect.split(/\s+/);
+      const varNames = [];
+      for (let ti = 0; ti < tokens.length; ti++) {
+        const tok = tokens[ti];
+        if (!tok) continue;
+        if (tok.startsWith("-")) {
+          if (/^-[antpidu]$|^-N$/.test(tok)) ti++;
+          continue;
+        }
+        if (/^[A-Za-z_][\w]*$/.test(tok)) varNames.push(tok);
+      }
+      if (varNames.length === 0) varNames.push("REPLY");
+      for (const v of varNames) {
+        const already = sources.some((s) => s.line === lineNumber && s.variable === v);
+        if (already) continue;
+        sources.push({
+          type: "io_input",
+          location: `read \u2192 $${v} (stdin)`,
+          severity: "high",
+          line: lineNumber,
+          confidence: 0.9,
+          variable: v
+        });
+      }
+    }
+    const mapfileMatch = /^(?:mapfile|readarray)\s*\(/.test(trimmed) ? null : trimmed.match(/^(?:mapfile|readarray)\b([^#(]*)$/);
+    if (mapfileMatch) {
+      const argStr = mapfileMatch[1].trim();
+      const tokens = argStr.split(/\s+/);
+      const varNames = [];
+      for (let ti = 0; ti < tokens.length; ti++) {
+        const tok = tokens[ti];
+        if (!tok) continue;
+        if (tok.startsWith("-")) {
+          if (/^-[cCnOsud]$/.test(tok)) ti++;
+          continue;
+        }
+        if (/^[A-Za-z_][\w]*$/.test(tok)) varNames.push(tok);
+      }
+      if (varNames.length === 0) varNames.push("MAPFILE");
+      for (const v of varNames) {
+        const already = sources.some((s) => s.line === lineNumber && s.variable === v);
+        if (already) continue;
+        sources.push({
+          type: "io_input",
+          location: `mapfile \u2192 $${v} (stdin array)`,
+          severity: "high",
+          line: lineNumber,
+          confidence: 0.9,
+          variable: v
+        });
+      }
+    }
+    const getoptsMatch = trimmed.match(/\bgetopts\s+["'][^"']+["']\s+(\w+)/);
+    if (getoptsMatch) {
+      const flagVar = getoptsMatch[1];
+      for (const v of [flagVar, "OPTARG"]) {
+        const already = sources.some((s) => s.line === lineNumber && s.variable === v);
+        if (already) continue;
+        sources.push({
+          type: "io_input",
+          location: `getopts \u2192 $${v} (CLI arg)`,
+          severity: "high",
+          line: lineNumber,
+          confidence: 0.9,
+          variable: v
+        });
+      }
+    }
     const envRe = /\$([A-Z][A-Z0-9_]{2,})|\$\{([A-Z][A-Z0-9_]{2,})\}/g;
     let em;
     while ((em = envRe.exec(line)) !== null) {

package/dist/core/circle-ir-core.cjs

@@ -10721,6 +10721,49 @@ var DEFAULT_SOURCES = [
   // Server-side interceptor receives `Metadata headers`; `headers.get(KEY)`
   // returns caller-supplied header values.
   { method: "get", class: "Metadata", type: "http_header", severity: "high", return_tainted: true, languages: ["java"] },
+  // --- WebSocket transport channels (cognium-dev #213 second slice) ---
+  //
+  // Server-side WebSocket handlers receive attacker-authored frames on
+  // every call to a receive-shaped method. Untrusted the moment they
+  // return, regardless of any application-level auth on the socket.
+  //
+  // Python — FastAPI / Starlette (`from fastapi import WebSocket`):
+  //   data = await websocket.receive_text()
+  //   data = await websocket.receive_bytes()
+  //   data = await websocket.receive_json()   # parsed dict/list
+  //   data = await websocket.receive()        # {'type', 'text'|'bytes'}
+  { method: "receive_text", class: "WebSocket", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_bytes", class: "WebSocket", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_json", class: "WebSocket", type: "http_body", severity: "high", return_tainted: true, languages: ["python"] },
+  //
+  // `receive` intentionally class-scoped to WebSocket (Starlette pattern).
+  // Broadening to unqualified would collide with queue/signal `.receive()`.
+  { method: "receive", class: "WebSocket", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  // Django Channels `AsyncJsonWebsocketConsumer` / `WebsocketConsumer`
+  // expose the same receive_* names on `self`; the class filter matches
+  // `WebSocket` only, so add unqualified fallbacks for the receive_json /
+  // receive_text convention (broad — no class filter possible without
+  // hardcoding Django's consumer names).
+  { method: "receive_json", type: "http_body", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_text", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_bytes", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  // Go — gorilla/websocket (`github.com/gorilla/websocket`):
+  //   messageType, message, err := conn.ReadMessage()
+  //   _, r, err := conn.NextReader()
+  { method: "ReadMessage", class: "Conn", type: "network_input", severity: "high", return_tainted: true, languages: ["go"] },
+  { method: "NextReader", class: "Conn", type: "network_input", severity: "high", return_tainted: true, languages: ["go"] },
+  // nhooyr.io/websocket exposes a `Read` method on `*websocket.Conn`;
+  // signature is `func (c *Conn) Read(ctx) (MessageType, []byte, error)`.
+  { method: "Read", class: "Conn", type: "network_input", severity: "high", return_tainted: true, languages: ["go"] },
+  // Java — Jakarta / Java WebSocket API (`javax.websocket` / `jakarta.websocket`):
+  //   session.getBasicRemote().sendText(input);      // OUT (not a source)
+  //   @OnMessage public void onMessage(String msg) — `msg` is a callback
+  //   param, not a return; handled via param_tainted when annotation is set.
+  { annotation: "OnMessage", type: "network_input", severity: "high", param_tainted: true, languages: ["java"] },
+  // Spring `@MessageMapping` STOMP-over-WebSocket handlers receive
+  // untrusted payloads on every dispatched frame.
+  { annotation: "MessageMapping", type: "http_body", severity: "high", param_tainted: true, languages: ["java"] },
+  { annotation: "SubscribeMapping", type: "http_body", severity: "high", param_tainted: true, languages: ["java"] },
   // --- Cache reads (second-order taint — Redis / Memcached / Django cache) ---
   // The cache round-trip is a canonical second-order sink: whatever was
   // written previously (potentially attacker-controlled) resurfaces on read.
@@ -12793,6 +12836,60 @@ var DEFAULT_SANITIZERS = [
   // Python Type coercion
   { method: "int", removes: ["sql_injection", "command_injection", "xss"] },
   { method: "float", removes: ["sql_injection", "command_injection"] },
+  // Python URL encoding (cognium-dev #213 fifth slice).
+  //
+  //   urllib.parse.quote(x)      — RFC-3986 percent-encode; safe for URL path
+  //   urllib.parse.quote_plus(x) — same + space→+; safe for query string
+  //   urllib.parse.urlencode(d)  — encode a dict of pairs
+  //
+  // Bounded to URL-context sinks. Class-scoped to the specific
+  // `urllib.parse` receiver to avoid colliding with unrelated bare
+  // `quote(...)` calls in other libraries.
+  { method: "quote", class: "urllib.parse", removes: ["ssrf", "open_redirect", "xss", "path_traversal"] },
+  { method: "quote_plus", class: "urllib.parse", removes: ["ssrf", "open_redirect", "xss", "path_traversal"] },
+  { method: "urlencode", class: "urllib.parse", removes: ["ssrf", "open_redirect", "xss"] },
+  // Bare aliases — `from urllib.parse import quote` then unqualified.
+  { method: "quote_plus", removes: ["ssrf", "open_redirect", "xss", "path_traversal"] },
+  { method: "urlencode", removes: ["ssrf", "open_redirect", "xss"] },
+  // `quote` bare is intentionally NOT registered — it collides with
+  // shlex.quote (bare-imported) which is a command_injection sanitizer,
+  // not a URL sanitizer. The class-scoped variant above catches the
+  // qualified `urllib.parse.quote(...)` shape; unqualified callers who
+  // want URL-context credit should use `quote_plus` (which does not
+  // collide with any command_injection sanitizer).
+  // Python XSS — additional common sanitizers.
+  //
+  //   bleach.clean(...)   — already covered above (line 2898)
+  //   bleach.linkify(...) — turns URLs into anchor tags; sanitizes as well
+  //   django.utils.html.escape / strip_tags — Django's XSS escape helpers
+  //   jinja2.escape       — Jinja2's Markup escape (aliased from markupsafe)
+  //   flask.escape        — Flask re-export of markupsafe.escape
+  //   saxutils.escape     — stdlib xml.sax.saxutils.escape for XML docs
+  { method: "linkify", class: "bleach", removes: ["xss"] },
+  // Bare `linkify(...)` alias — `from bleach import linkify`.
+  { method: "linkify", removes: ["xss"] },
+  { method: "escape", class: "django.utils.html", removes: ["xss"] },
+  { method: "strip_tags", class: "django.utils.html", removes: ["xss"] },
+  { method: "escape", class: "jinja2", removes: ["xss"] },
+  { method: "escape", class: "flask", removes: ["xss"] },
+  { method: "escape", class: "saxutils", removes: ["xss"] },
+  { method: "escape", class: "xml.sax.saxutils", removes: ["xss"] },
+  { method: "quoteattr", class: "saxutils", removes: ["xss"] },
+  { method: "quoteattr", class: "xml.sax.saxutils", removes: ["xss"] },
+  // Python ReDoS — `re.escape(user)` when building a regex from user input
+  // strips regex metacharacters. Downstream `re.compile / re.match` cannot
+  // interpret user-supplied alternations or quantifiers. Also covers the
+  // `code_injection` categorization that `re.compile` currently emits
+  // (a re.escape-wrapped pattern cannot execute anything, so both are safe).
+  { method: "escape", class: "re", removes: ["redos", "code_injection"] },
+  // Python SQLAlchemy — `text(...).bindparams(...)` binds params safely.
+  // The `bindparams` call is the sanitizer; the parent `text` wraps the
+  // template. Also add `expression.literal` for explicit SQL literals.
+  { method: "bindparams", removes: ["sql_injection"] },
+  // psycopg2 sql-composition helpers
+  { method: "Identifier", class: "sql", removes: ["sql_injection"] },
+  { method: "Literal", class: "sql", removes: ["sql_injection"] },
+  { method: "Placeholder", class: "sql", removes: ["sql_injection"] },
   // =========================================================================
   // Rust Sanitizers
   // =========================================================================
@@ -14621,7 +14718,14 @@ function matchesSanitizerPattern(call, pattern) {
       return false;
     }
     if (pattern.class) {
-      if (!call.receiver || !receiverMightBeClass(call.receiver, pattern.class)) {
+      if (!call.receiver) {
+        const target = call.resolution?.target;
+        const expectedTail = `${pattern.class}.${pattern.method}`;
+        if (target && (target === expectedTail || target.endsWith("." + expectedTail))) {
+        } else {
+          return false;
+        }
+      } else if (!receiverMightBeClass(call.receiver, pattern.class)) {
         return false;
       }
     }

package/dist/core/circle-ir-core.js

@@ -10655,6 +10655,49 @@ var DEFAULT_SOURCES = [
   // Server-side interceptor receives `Metadata headers`; `headers.get(KEY)`
   // returns caller-supplied header values.
   { method: "get", class: "Metadata", type: "http_header", severity: "high", return_tainted: true, languages: ["java"] },
+  // --- WebSocket transport channels (cognium-dev #213 second slice) ---
+  //
+  // Server-side WebSocket handlers receive attacker-authored frames on
+  // every call to a receive-shaped method. Untrusted the moment they
+  // return, regardless of any application-level auth on the socket.
+  //
+  // Python — FastAPI / Starlette (`from fastapi import WebSocket`):
+  //   data = await websocket.receive_text()
+  //   data = await websocket.receive_bytes()
+  //   data = await websocket.receive_json()   # parsed dict/list
+  //   data = await websocket.receive()        # {'type', 'text'|'bytes'}
+  { method: "receive_text", class: "WebSocket", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_bytes", class: "WebSocket", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_json", class: "WebSocket", type: "http_body", severity: "high", return_tainted: true, languages: ["python"] },
+  //
+  // `receive` intentionally class-scoped to WebSocket (Starlette pattern).
+  // Broadening to unqualified would collide with queue/signal `.receive()`.
+  { method: "receive", class: "WebSocket", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  // Django Channels `AsyncJsonWebsocketConsumer` / `WebsocketConsumer`
+  // expose the same receive_* names on `self`; the class filter matches
+  // `WebSocket` only, so add unqualified fallbacks for the receive_json /
+  // receive_text convention (broad — no class filter possible without
+  // hardcoding Django's consumer names).
+  { method: "receive_json", type: "http_body", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_text", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  { method: "receive_bytes", type: "network_input", severity: "high", return_tainted: true, languages: ["python"] },
+  // Go — gorilla/websocket (`github.com/gorilla/websocket`):
+  //   messageType, message, err := conn.ReadMessage()
+  //   _, r, err := conn.NextReader()
+  { method: "ReadMessage", class: "Conn", type: "network_input", severity: "high", return_tainted: true, languages: ["go"] },
+  { method: "NextReader", class: "Conn", type: "network_input", severity: "high", return_tainted: true, languages: ["go"] },
+  // nhooyr.io/websocket exposes a `Read` method on `*websocket.Conn`;
+  // signature is `func (c *Conn) Read(ctx) (MessageType, []byte, error)`.
+  { method: "Read", class: "Conn", type: "network_input", severity: "high", return_tainted: true, languages: ["go"] },
+  // Java — Jakarta / Java WebSocket API (`javax.websocket` / `jakarta.websocket`):
+  //   session.getBasicRemote().sendText(input);      // OUT (not a source)
+  //   @OnMessage public void onMessage(String msg) — `msg` is a callback
+  //   param, not a return; handled via param_tainted when annotation is set.
+  { annotation: "OnMessage", type: "network_input", severity: "high", param_tainted: true, languages: ["java"] },
+  // Spring `@MessageMapping` STOMP-over-WebSocket handlers receive
+  // untrusted payloads on every dispatched frame.
+  { annotation: "MessageMapping", type: "http_body", severity: "high", param_tainted: true, languages: ["java"] },
+  { annotation: "SubscribeMapping", type: "http_body", severity: "high", param_tainted: true, languages: ["java"] },
   // --- Cache reads (second-order taint — Redis / Memcached / Django cache) ---
   // The cache round-trip is a canonical second-order sink: whatever was
   // written previously (potentially attacker-controlled) resurfaces on read.
@@ -12727,6 +12770,60 @@ var DEFAULT_SANITIZERS = [
   // Python Type coercion
   { method: "int", removes: ["sql_injection", "command_injection", "xss"] },
   { method: "float", removes: ["sql_injection", "command_injection"] },
+  // Python URL encoding (cognium-dev #213 fifth slice).
+  //
+  //   urllib.parse.quote(x)      — RFC-3986 percent-encode; safe for URL path
+  //   urllib.parse.quote_plus(x) — same + space→+; safe for query string
+  //   urllib.parse.urlencode(d)  — encode a dict of pairs
+  //
+  // Bounded to URL-context sinks. Class-scoped to the specific
+  // `urllib.parse` receiver to avoid colliding with unrelated bare
+  // `quote(...)` calls in other libraries.
+  { method: "quote", class: "urllib.parse", removes: ["ssrf", "open_redirect", "xss", "path_traversal"] },
+  { method: "quote_plus", class: "urllib.parse", removes: ["ssrf", "open_redirect", "xss", "path_traversal"] },
+  { method: "urlencode", class: "urllib.parse", removes: ["ssrf", "open_redirect", "xss"] },
+  // Bare aliases — `from urllib.parse import quote` then unqualified.
+  { method: "quote_plus", removes: ["ssrf", "open_redirect", "xss", "path_traversal"] },
+  { method: "urlencode", removes: ["ssrf", "open_redirect", "xss"] },
+  // `quote` bare is intentionally NOT registered — it collides with
+  // shlex.quote (bare-imported) which is a command_injection sanitizer,
+  // not a URL sanitizer. The class-scoped variant above catches the
+  // qualified `urllib.parse.quote(...)` shape; unqualified callers who
+  // want URL-context credit should use `quote_plus` (which does not
+  // collide with any command_injection sanitizer).
+  // Python XSS — additional common sanitizers.
+  //
+  //   bleach.clean(...)   — already covered above (line 2898)
+  //   bleach.linkify(...) — turns URLs into anchor tags; sanitizes as well
+  //   django.utils.html.escape / strip_tags — Django's XSS escape helpers
+  //   jinja2.escape       — Jinja2's Markup escape (aliased from markupsafe)
+  //   flask.escape        — Flask re-export of markupsafe.escape
+  //   saxutils.escape     — stdlib xml.sax.saxutils.escape for XML docs
+  { method: "linkify", class: "bleach", removes: ["xss"] },
+  // Bare `linkify(...)` alias — `from bleach import linkify`.
+  { method: "linkify", removes: ["xss"] },
+  { method: "escape", class: "django.utils.html", removes: ["xss"] },
+  { method: "strip_tags", class: "django.utils.html", removes: ["xss"] },
+  { method: "escape", class: "jinja2", removes: ["xss"] },
+  { method: "escape", class: "flask", removes: ["xss"] },
+  { method: "escape", class: "saxutils", removes: ["xss"] },
+  { method: "escape", class: "xml.sax.saxutils", removes: ["xss"] },
+  { method: "quoteattr", class: "saxutils", removes: ["xss"] },
+  { method: "quoteattr", class: "xml.sax.saxutils", removes: ["xss"] },
+  // Python ReDoS — `re.escape(user)` when building a regex from user input
+  // strips regex metacharacters. Downstream `re.compile / re.match` cannot
+  // interpret user-supplied alternations or quantifiers. Also covers the
+  // `code_injection` categorization that `re.compile` currently emits
+  // (a re.escape-wrapped pattern cannot execute anything, so both are safe).
+  { method: "escape", class: "re", removes: ["redos", "code_injection"] },
+  // Python SQLAlchemy — `text(...).bindparams(...)` binds params safely.
+  // The `bindparams` call is the sanitizer; the parent `text` wraps the
+  // template. Also add `expression.literal` for explicit SQL literals.
+  { method: "bindparams", removes: ["sql_injection"] },
+  // psycopg2 sql-composition helpers
+  { method: "Identifier", class: "sql", removes: ["sql_injection"] },
+  { method: "Literal", class: "sql", removes: ["sql_injection"] },
+  { method: "Placeholder", class: "sql", removes: ["sql_injection"] },
   // =========================================================================
   // Rust Sanitizers
   // =========================================================================
@@ -14555,7 +14652,14 @@ function matchesSanitizerPattern(call, pattern) {
       return false;
     }
     if (pattern.class) {
-      if (!call.receiver || !receiverMightBeClass(call.receiver, pattern.class)) {
+      if (!call.receiver) {
+        const target = call.resolution?.target;
+        const expectedTail = `${pattern.class}.${pattern.method}`;
+        if (target && (target === expectedTail || target.endsWith("." + expectedTail))) {
+        } else {
+          return false;
+        }
+      } else if (!receiverMightBeClass(call.receiver, pattern.class)) {
         return false;
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "circle-ir",
-  "version": "3.182.0",
+  "version": "3.185.0",
   "description": "High-performance Static Application Security Testing (SAST) library for detecting security vulnerabilities through taint analysis",
   "main": "dist/index.js",
   "module": "dist/index.js",