clog: add 2026-01-16 release notes (Chromium 144.0.7559.76), docs cleanup

Author: MSTU0

ADVANCED_FEATURES.md

@@ -14,7 +14,7 @@ BotBrowser provides multi-layer controls to maintain protected fingerprints acro
 
 ## Capabilities Index
 
-[navigator.webdriver removal](#chrome-behavior-emulation), [main-world isolation](#playwright-puppeteer-integration), [JS hook isolation](#playwright-puppeteer-integration), [Canvas noise](#graphics-rendering-engine), [WebGL/WebGPU param control](#graphics-rendering-engine), [Skia anti-alias](#cross-platform-font-engine), [HarfBuzz shaping](#cross-platform-font-engine), [MediaDevices protection](#complete-fingerprint-control), [font list authenticity](#cross-platform-font-engine), [UA congruence](#configuration-and-control), [per-context proxy (ENT Tier1) geo](#enhanced-proxy-system), [DNS-through-proxy](#enhanced-proxy-system), [active window emulation](#active-window-emulation), [HTTP headers/HTTP2/HTTP3](#chrome-behavior-emulation), [headless parity](#headless-incognito-compatibility), [WebRTC SDP/ICE control](#webrtc-leak-protection), [TLS fingerprint (JA3/JARM)](#network-fingerprint-control), [distributed privacy consistency](#mirror-distributed-privacy-consistency)
+[navigator.webdriver removal](#chrome-behavior-emulation), [main-world isolation](#playwright-puppeteer-integration), [JS hook isolation](#playwright-puppeteer-integration), [Canvas noise](#graphics-rendering-engine), [WebGL/WebGPU param control](#graphics-rendering-engine), [Skia anti-alias](#cross-platform-font-engine), [HarfBuzz shaping](#cross-platform-font-engine), [MediaDevices protection](#complete-fingerprint-control), [font list authenticity](#cross-platform-font-engine), [UA congruence](#configuration-and-control), [custom User-Agent (ENT Tier3)](#custom-user-agent), [per-context proxy (ENT Tier1) geo](#enhanced-proxy-system), [DNS-through-proxy](#enhanced-proxy-system), [active window emulation](#active-window-emulation), [HTTP headers/HTTP2/HTTP3](#chrome-behavior-emulation), [headless parity](#headless-incognito-compatibility), [WebRTC SDP/ICE control](#webrtc-leak-protection), [TLS fingerprint (JA3/JARM)](#network-fingerprint-control), [distributed privacy consistency](#mirror-distributed-privacy-consistency)
 
 <a id="configuration-and-control"></a>
 ## Configuration & Control
@@ -40,6 +40,35 @@ chrome.exe --bot-profile="C:\\absolute\\path\\to\\profile.enc" \
            --bot-config-locale="auto"
 ```
 
+<a id="custom-user-agent"></a>
+### Custom User-Agent (ENT Tier3)
+Full control over User-Agent string and userAgentData for building any browser identity.
+
+**Flags:**
+- `--bot-config-platform` (Windows, Android, macOS, Linux)
+- `--bot-config-platform-version` (OS version)
+- `--bot-config-model` (device model for mobile)
+- `--bot-config-architecture` (x86, arm, arm64)
+- `--bot-config-bitness` (32, 64)
+- `--bot-config-mobile` (true, false)
+- `--bot-config-browser-brand=webview` (WebView brand support)
+
+**Placeholders in `--user-agent`:**
+Use `{platform}`, `{platform-version}`, `{model}`, `{ua-full-version}`, `{ua-major-version}`, `{brand-full-version}`, `{architecture}`, `{bitness}` in your UA string. BotBrowser replaces them at runtime from flags or fingerprint config.
+
+**Example: Android WebView**
+```bash
+chrome.exe --bot-profile="/path/to/android-profile.enc" \
+  --user-agent="Mozilla/5.0 (Linux; Android {platform-version}; {model} Build/TP1A.220624.021; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/{ua-full-version} Mobile Safari/537.36" \
+  --bot-config-browser-brand=webview \
+  --bot-config-platform=Android \
+  --bot-config-platform-version=13 \
+  --bot-config-model=RMX3471 \
+  --bot-config-mobile=true
+```
+
+BotBrowser auto-generates matching `navigator.userAgentData` (brands, fullVersionList with GREASE algorithm) and all Sec-CH-UA-* headers. Values stay consistent across main thread, workers, and HTTP requests.
+
 ### Session Management
 Comprehensive tools for session control and identification.
 
@@ -177,7 +206,7 @@ Maintains protected window state to prevent focus-based tracking even when the h
 - Configurable per-window to allow legitimate focus-change observation when required by applications
 - Protects against window focus based tracking heuristics that monitor caret blinking, FocusManager events, or inactive viewport throttling
 - README quick link: see [Workflows → Active Window](README.md#advanced-capabilities)
-- CLI reference: [`--bot-always-active`](CLI_FLAGS.md#⚙️-profile-configuration-override-flags)
+- CLI reference: [`--bot-always-active`](CLI_FLAGS.md#profile-configuration-override-flags)
 
 <a id="headless-incognito-compatibility"></a>
 ### Headless & Incognito Compatibility
@@ -208,7 +237,7 @@ Complete WebRTC fingerprint protection and network privacy protection.
 - RTCPeerConnection behavior standardization
 - Network topology protection through controlled signal patterns
 - ICE server presets and custom lists via `--bot-webrtc-ice` (ENT Tier1) to standardize STUN and TURN endpoints observed by page JavaScript
-- Combined with UDP-over-SOCKS5 (ENT Tier3) you achieve Chromium-level QUIC and STUN tunneling for complete network protection; see [`Network Fingerprint Control`](ADVANCED_FEATURES.md#network-fingerprint-control) and [`CLI_FLAGS`](CLI_FLAGS.md#⚙️-profile-configuration-override-flags) for implementation examples.
+- Combined with UDP-over-SOCKS5 (ENT Tier3) you achieve Chromium-level QUIC and STUN tunneling for complete network protection; see [`Network Fingerprint Control`](ADVANCED_FEATURES.md#network-fingerprint-control) and [`CLI_FLAGS`](CLI_FLAGS.md#profile-configuration-override-flags) for implementation examples.
 
 <a id="chrome-behavior-emulation"></a>
 ### Chrome Behavior Emulation
@@ -420,11 +449,12 @@ Comprehensive browser and OS emulation.
 
 | Component | Capabilities |
 |-----------|-------------|
-| **User Agent** | Version control, userAgentData brands, full version override |
+| **User Agent** | Version control, userAgentData brands, full version override, custom UA with placeholders (ENT Tier3) |
 | **Platform Detection** | Windows/macOS/Android(PRO) with authentic APIs |
-| **Browser Features** | Debugger disabling, CDP leak blocking, Chrome-specific behavior |
+| **Browser Features** | Debugger disabling, CDP leak blocking, Chrome-specific behavior, WebView brand (ENT Tier3) |
 | **Font System** | Built-in cross-platform fonts, Blink features, authentic fallback chains |
 | **Client Hints** | DPR, device-memory, UA-CH, and other CH values stay aligned with JavaScript-visible metrics so headers and runtime data always match |
+| **userAgentData** | Full control over platform, platformVersion, model, architecture, bitness, mobile (ENT Tier3) |
 
 ### Location & Time Management
 Precise geolocation and temporal controls.
@@ -514,7 +544,7 @@ chrome.exe --bot-profile="C:\\absolute\\path\\to\\profile.enc" --bot-script="scr
 - `chrome.runtime` - Runtime APIs and event handling
 - Standard browser APIs (console, setTimeout, etc.)
 
-📖 **Documentation:** [Bot Script Examples](examples/bot-script)
+**Documentation:** [Bot Script Examples](examples/bot-script)
 
 <a id="playwright-puppeteer-integration"></a>
 ### Playwright/Puppeteer Integration

CHANGELOG.md

@@ -3,6 +3,16 @@
 > **Research scope:** Entries in this changelog describe features evaluated in authorized labs and defensive benchmarking programs. Follow the [Legal Disclaimer](DISCLAIMER.md) and [Responsible Use Guidelines](RESPONSIBLE_USE.md). We work with security vendors to investigate any misuse, so report concerns to [botbrowser@bk.ru](mailto:botbrowser@bk.ru).
 
 
+## [2026-01-16]
+### Major
+- **Chromium Core → 144.0.7559.76**: Updated the engine to the latest Chrome 144 stable (144.0.7559.76). This keeps Web Platform behavior, rendering consistency, and security patches aligned with upstream Chrome.
+
+- **Custom User-Agent and userAgentData (ENT Tier3)**: Full control over User-Agent string and `navigator.userAgentData` for building any browser identity, including Android WebView simulation. Configure platform, platformVersion, model, architecture, bitness, and mobile flag via `--user-agent` with placeholders (`{platform}`, `{model}`, etc.) that get replaced at runtime. BotBrowser auto-generates matching brands, fullVersionList with GREASE, and Sec-CH-UA-* headers. Values stay consistent across main thread, workers, and HTTP requests. See [CLI_FLAGS.md](CLI_FLAGS.md#custom-user-agent-with-webview-ent-tier3) for usage.
+
+### Improvements
+- **UDP over SOCKS5 stability (ENT Tier3)**: Improved UDP associate handling for QUIC and STUN traffic over SOCKS5 proxies. The implementation now handles complex network environments more gracefully, reducing connection timeouts, latency spikes, and stuttering during high-throughput or unstable network conditions.
+
+
 ## [2026-01-12]
 ### Major
 - **Chromium Core → 144.0.7559.59**: Updated the engine to Chrome 144 early release (144.0.7559.59) to stay ahead with the latest Chrome development. This maintains Web Platform parity, rendering consistency, and security patches with upstream.

CLI_FLAGS.md

@@ -6,7 +6,7 @@ This document explains BotBrowser's CLI configuration system. These flags extend
 
 > Smart auto-configuration: BotBrowser derives timezone, locale, and languages from your IP/proxy. Override only when you need a specific setup.
 
-> Dynamic configuration: CLI overrides (`--bot-config-*` + behavior toggles) enable runtime fingerprint control, which is ideal for CI/CD and multi-instance scenarios.
+> Dynamic configuration: `--bot-*` flags (config overrides + behavior toggles) enable runtime fingerprint control, which is ideal for CI/CD and multi-instance scenarios.
 
 > License tiers: Some flags show tier hints in parentheses (PRO, ENT Tier1/Tier2/Tier3); those options are subscription-gated.
 
@@ -230,14 +230,35 @@ BotBrowser supports command-line flags that override profile configuration value
 Flags that directly map to profile `configs` and override them at runtime.
 
 **Identity & Locale**
-- `--bot-config-browser-brand=chrome` (ENT Tier2): Browser brand: chrome, chromium, edge, brave, opera
+- `--bot-config-browser-brand=chrome` (ENT Tier2, webview requires ENT Tier3): Browser brand: chrome, chromium, edge, brave, opera, webview
 - `--bot-config-brand-full-version=142.0.3595.65` (ENT Tier2): Brand-specific full version (Edge/Opera cadence) for UA-CH congruence
 - `--bot-config-ua-full-version=142.0.7444.60` (ENT Tier2): User agent version: full version string matching Chromium major
 - `--bot-config-languages=auto` (ENT Tier1): Languages: "lang1,lang2" (comma-separated) or "auto" (IP-based)
 - `--bot-config-locale=auto` (ENT Tier1): Browser locale: e.g. en-US, fr-FR, de-DE, or "auto" (derived from IP/language)
 - `--bot-config-timezone=auto` (ENT Tier1): Timezone: auto (IP-based), real (system), or timezone name
 - `--bot-config-location=40.7128,-74.0060` (ENT Tier1): Location: "lat,lon" (coordinates) or "auto" (IP-based)
 
+**Custom User-Agent (ENT Tier3)**
+
+Build any browser identity with full userAgentData control. These flags work together with `--user-agent` to construct a complete, internally consistent browser identity.
+
+- `--bot-config-platform=Android`: Platform name: Windows, Android, macOS, Linux
+- `--bot-config-platform-version=13`: OS version string
+- `--bot-config-model=RMX3471`: Device model (primarily for mobile)
+- `--bot-config-architecture=arm`: CPU architecture: x86, arm, arm64
+- `--bot-config-bitness=64`: System bitness: 32, 64
+- `--bot-config-mobile=true`: Mobile device flag
+
+The `--user-agent` flag supports placeholders that get replaced at runtime:
+- `{platform}`, `{platform-version}`, `{model}` for device info
+- `{ua-full-version}`, `{ua-major-version}` for Chromium version
+- `{brand-full-version}` for brand-specific version (Edge, Opera)
+- `{architecture}`, `{bitness}` for CPU info
+
+BotBrowser auto-generates matching `navigator.userAgentData` (brands, fullVersionList with proper GREASE) and all Sec-CH-UA-* headers. Values stay consistent across main thread, workers, and HTTP requests.
+
+> **Note: UA/Engine Congruence:** Keep `--bot-config-ua-full-version` aligned with your Chromium major version, and use `--bot-config-brand-full-version` when a vendor's cadence (Edge, Opera, Brave) diverges so UA-CH metadata stays internally protected.
+
 **Display & Input**
 - `--bot-config-window=profile`: Window dimensions: profile (use profile), real (system window)
 - `--bot-config-screen=profile`: Screen properties: profile (use profile), real (system screen)
@@ -259,8 +280,6 @@ Flags that directly map to profile `configs` and override them at runtime.
 - `--bot-config-media-types=expand`: Media types: expand (default), profile, real
 - `--bot-config-webrtc=profile`: WebRTC: profile (use profile), real (native), disabled (off)
 
-> **Note: UA/Engine Congruence:** Keep `--bot-config-ua-full-version` aligned with your Chromium major version, and use `--bot-config-brand-full-version` when a vendor's cadence (Edge, Opera, Brave) diverges so UA-CH metadata stays internally protected.
-
 ### Behavior & Protection Toggles
 
 Runtime toggles that don’t rely on profile `configs` but still override behavior at launch.
@@ -316,7 +335,6 @@ Verify that your privacy protection works effectively across platforms and netwo
 ---
 
 ## Usage Examples
-📌 Quick launch patterns and reference commands.
 
 ### Minimal launch with proxy
 ```bash
@@ -362,15 +380,32 @@ chromium-browser \
   --user-data-dir="/tmp/instance2" &
 ```
 
-### Performance timing & noise control (ENT)
+### Performance timing & noise control (ENT Tier2)
 ```bash
 # Stabilize performance timing and noise determinism under load
 chromium-browser \
   --bot-profile="/absolute/path/to/profile.enc" \
-  --bot-time-scale=0.92 \  # ENT Tier1 feature
+  --bot-time-scale=0.92 \  # ENT Tier2 feature
   --bot-noise-seed=1.07   # ENT Tier2 feature
 ```
 
+### Custom User-Agent with WebView (ENT Tier3)
+```bash
+# Android WebView simulation with placeholders
+chromium-browser \
+  --bot-profile="/absolute/path/to/android-profile.enc" \
+  --user-agent="Mozilla/5.0 (Linux; Android {platform-version}; {model} Build/TP1A.220624.021; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/{ua-full-version} Mobile Safari/537.36" \
+  --bot-config-browser-brand=webview \
+  --bot-config-platform=Android \
+  --bot-config-platform-version=13 \
+  --bot-config-model=RMX3471 \
+  --bot-config-mobile=true \
+  --bot-config-architecture=arm \
+  --bot-config-bitness=64
+```
+
+Placeholders like `{platform-version}` and `{model}` get replaced from flags or fingerprint config. BotBrowser generates matching userAgentData and Client Hints automatically.
+
 ---
 
 ## Related Documentation
@@ -384,7 +419,7 @@ chromium-browser \
 ---
 
 ## Tips & Best Practices
-💡 Practical pointers for stable runs.
+Practical pointers for stable runs.
 
 ### BotBrowser-Specific Considerations