Commit Graph
1 Commits
Author SHA1 Message Date
dependabot[bot]andJerrettDavis 038af599e1 deps: Bump lru from 0.18.5 to 0.19.0 (#4382)
## Why this version

Upgrade the native proxy's bounded session caches from lru 0.18.5 to
0.19.0 to retain the upstream iterator soundness correction. The
official 0.19.0 changelog says "Require Sync for sendable shared
iterators." In source, `Send for Iter<'a, K, V>` now requires `K: Sync,
V: Sync`, replacing `K: Send, V: Send`: the iterator yields shared
references, which may cross threads only when their referents are Sync.

Headroom uses this crate for the shared `BetaStickyState` session
beta-token union and `DriftState` structural-hash history. Both live in
`Arc<Mutex<LruCache<...>>>` and are cloned into concurrent request
handlers. They use String / Vec<String> / StructuralHash values; they do
not transfer shared iterators across threads. Thus this updates a
concurrency-sensitive dependency to its corrected upstream contract; it
does not claim that current Headroom calls demonstrate an exploit or
require a new API.

The patch preserves the 0.19 target and adds the dependency rationale
beside its declaration, removes an obsolete lru 0.12 documentation
reference, and mechanically merges current main so the current security
workflows and fixes are included.

## Compatibility and installation

This is a pre-1.0 minor bump, so compatibility was checked rather than
assumed. The only dependency introduced by lru remains hashbrown 0.17.1.
The crate's MSRV is 1.85.0 in both 0.18.5 and 0.19.0; this bump does not
raise it. Headroom's workspace rust-version=1.80 already understates
that dependency floor; its pinned toolchain is 1.95.0, used for this
validation. Correcting the workspace-wide MSRV declaration is outside
this dependency patch.

Native installation already builds the ONNX/image/AWS dependency stack
and may fetch build dependencies and ONNX Runtime artifacts; lru adds no
build script or model download. This was a fresh isolated native target
build using the existing registry/artifact caches, not a clean
offline-install certification. Runtime validation disables model
downloads with HEADROOM_OFFLINE/HF_HUB_OFFLINE and uses only local fake
upstreams, with no cloud inference or credentials.

## Validation

- `cargo test -p headroom-proxy --lib cache_stabilization --locked`: 105
passed, including concurrent_unions_lose_no_tokens (8 threads, 50
updates each), LRU eviction and recency checks.
- `cargo fmt --all -- --check`: passed.
- `git diff --check`: passed.
- `cargo test -p headroom-proxy --test integration_cache_drift --test
integration_cache_control --test integration_e3_anthropic_cache_control
--test integration_e4_openai_cache_key --locked`: 20 passed across four
binaries (1/8/5/6).
- `cargo build -p headroom-proxy --locked`: passed with Rust 1.95.0 on
Windows MSVC.
- `python scripts/verify_native_session_caches.py --proxy
target/debug/headroom-proxy`: passed. A separately spawned native binary
forwarded 12 requests to an ephemeral loopback fake Anthropic upstream
without credentials. Sequential requests retained beta-a,beta-b; eight
concurrent same-session requests retained all token-0 through token-7 in
the next request. Logs recorded both first-seen and changed-system drift
events. Both proxy and fake upstream were cleaned up. Compression
interception was enabled with compression-mode off; this exercises the
actual session caches and byte passthrough, not model compression or
cloud behavior.
- The standard-library runtime proof is committed as
`scripts/verify_native_session_caches.py`; no private artifacts are
required. Security/CI approval and remote branch update remain separate
gates; this local proof does not certify hosted checks.

Official upstream references:
https://github.com/jeromefroe/lru-rs/blob/0.19.0/CHANGELOG.md and
https://github.com/jeromefroe/lru-rs/blob/0.19.0/src/lib.rs .

## Reproduce the native loopback proof

From the repository root, with its pinned Rust toolchain and Python 3:

```sh
cargo build -p headroom-proxy --locked
python scripts/verify_native_session_caches.py --proxy target/debug/headroom-proxy
```

On Windows use `--proxy target/debug/headroom-proxy.exe`. If
`CARGO_TARGET_DIR` is set, pass the binary under that directory instead.
Optional `--log /path/to/proxy.log` preserves logs; otherwise logs and
the child working directory are temporary. The script uses only Python's
standard library, strips provider/Headroom configuration environment
variables, disables model egress, bypasses caller HTTP proxy settings,
disables stats persistence, and starts only its own loopback fake
upstream and native child. It returns nonzero on readiness, forwarding,
sticky-union, or drift-event failures and cleans up its processes.

This proof was rerun after making the harness portable: all 12 upstream
requests passed. Current main was fetched again and remains
`74277d47ecfbca349ddb99f81094c4dd30539d43`, already included in this
candidate.

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-11-03 08:45:55 -06:00