feat(cache): shared redis cache, snapshot keys, uncached write pipes - #614

Merged

EricAndrechek merged 108 commits into

mainfrom

feat/cache-snapshot

Sep 26, 2026

Commits on Sep 24, 2026

feat(mq): give every tenant a queue of its own
taitelee
committed
ef93154

Commits on Sep 25, 2026

feat(config): choose each layer's implementation at boot

EricAndrechek
and
claude
committed
3022b92
docs(config): say coord.backend is reserved; sync the boot-config lists

EricAndrechek
and
claude
committed
fde17ba
fix(cache): snapshot versions at lookup; tenant token on every key

EricAndrechek
and
claude
committed
431084e
docs(config): no backend has a sub-block yet; index backends.go in AGENTS.md

EricAndrechek
and
claude
committed
f129d57
perf(cache): flat version index, pruned per tenant

EricAndrechek
and
claude
committed
67df317
docs(cache): name the cache prune hook; pin LocalCache as a pruner

EricAndrechek
and
claude
committed
ed8022b
feat(cache): Redis-compatible shared cache backend

EricAndrechek
and
claude
committed
50b7e0c
fix(cache): count only transport failures against the breaker

EricAndrechek
and
claude
committed
e346426
fix(cache): replace token and value keys of the wrong type

EricAndrechek
and
claude
committed
d2a87ab
test(cov): keep the unreachable Redis backend out of the e2e gate

EricAndrechek
and
claude
committed
d67a46a
Merge remote-tracking branch 'origin/feat/boot-backends' into feat/cache-redis-wiring
EricAndrechek
committed
44cec4d
Merge remote-tracking branch 'origin/feat/cache-flat-versions' into feat/cache-redis-wiring
EricAndrechek
committed
85803f0
feat(config): cache.backend=redis selects the shared cache

EricAndrechek
and
claude
committed
c068084
fix(cache): review round — e2e gate, trust boundary, #386, addr spaces

EricAndrechek
and
claude
committed
13c6cb3
fix(pipes): run write pipes every call, uncached and uncoalesced

EricAndrechek
and
claude
committed
1134d5c
fix(pipes): no-store on write pipes; reconcile the mutation-path docs

EricAndrechek
and
claude
committed
74a7bf4
docs(pipes): name the operator as a write pipe's author; no-store in api.md

EricAndrechek
and
claude
committed
7bb8c27
Merge remote-tracking branch 'origin/main' into feat/cache-snapshot

EricAndrechek
and
claude
committed
264d71b
refactor(keyenc): one escaping for subject and cache key tokens

EricAndrechek
and
claude
committed
ce14795
docs(keyenc): name only the keys built from it today

EricAndrechek
and
claude
committed
51db11c
docs(architecture): keyenc is not yet every composite key's escaping

EricAndrechek
and
claude
committed
27f7608
Merge origin/feat/cache-snapshot into feat/cache-flat-versions

EricAndrechek
and
claude
committed
ca16db5
Merge remote-tracking branch 'origin/main' into refactor/keyenc
EricAndrechek
committed
673f461
refactor(keyenc): keep '-', join keys, count dead letters per table

EricAndrechek
and
claude
committed
2c31eff
Merge branch 'refactor/keyenc' into feat/cache-snapshot
EricAndrechek
committed
011fb93
docs(keyenc): pin the %2D compatibility to builds since #612

EricAndrechek
and
claude
committed
999e92c
refactor(cache): namespaces carry raw names; the cache escapes its keys

EricAndrechek
and
claude
committed
cc516d8
Merge branch 'feat/cache-snapshot' into feat/cache-redis
EricAndrechek
committed
4552f91
test(mq): cover a byte left unescaped in the lenient-token case

EricAndrechek
and
claude
committed
79ab364
refactor(cache): the Redis codec escapes the raw names it keys

EricAndrechek
and
claude
committed
40d817d
Merge branch 'refactor/keyenc' into feat/cache-snapshot
EricAndrechek
committed
d03178b
Merge branch 'feat/cache-snapshot' into feat/cache-redis
EricAndrechek
committed
c004690

Commits on Sep 26, 2026

docs(cache): one name for keyenc's cache keys; the entry key's lead field

EricAndrechek
and
claude
committed
972a53d
Merge branch 'feat/cache-snapshot' into feat/cache-redis
EricAndrechek
committed
3d2a8fb
docs(cache): the Redis token-key layout is a protocol between builds

EricAndrechek
and
claude
committed
1e70d64
docs(cache): InvalidateTenant drops pipe results; a pipe passes no deps

EricAndrechek
and
claude
committed
dbd3681
Merge branch 'feat/cache-snapshot' into feat/cache-redis
EricAndrechek
committed
a7c86d5
docs(cache): a token-key layout change needs both layouts read and bumped

EricAndrechek
and
claude
committed
e6a824a
docs(changelog): #382 never reached pipes; entry keys gained the tenant version

EricAndrechek
and
claude
committed
674e0e2
Merge remote-tracking branch 'origin/main' into feat/cache-snapshot

EricAndrechek
and
claude
committed
8541758
test(app): assert the wired cache is a pruner before swapping it

EricAndrechek
and
claude
committed
ee51e84
Merge main (5004cd23) into feat/cache-redis-wiring

EricAndrechek
and
claude
committed
fcf1e89
Merge main (5004cd23) into feat/cache-snapshot

EricAndrechek
and
claude
committed
e9204e6
fix(cache): take the snapshot before choosing the tenant's pool

EricAndrechek
and
claude
committed
55eb103
fix(api): classify writes the way ClickHouse lexes them

EricAndrechek
and
claude
committed
19720fb
fix(config): cache.redis defaults in defaults(); 0 never compresses

EricAndrechek
and
claude
committed
9a4888a
fix(cache): give the two-instance test its roles; redis is the shared cache

EricAndrechek
and
claude
committed
6fa1ae6
fix(config): refuse cache.redis.mode=sentinel until #656

EricAndrechek
and
claude
committed
712b1db
fix(config): refuse a URL-style cache.redis address without echoing it

EricAndrechek
and
claude
committed
a7ef71f
fix(config): cap cache.redis.dial_timeout at 2s

EricAndrechek
and
claude
committed
de27b60
docs(cache): only a move to another address or database bumps a tenant

EricAndrechek
and
claude
committed
972ff30
test(cache): the local backend's insert-invalidates lifecycle, end to end

EricAndrechek
and
claude
committed
8189783
fix(ingest): log an invalidation that did not land at WARN

EricAndrechek
and
claude
committed
5e84762
fix(cache): owed bumps hold lookups; refused writes open the breaker

EricAndrechek
and
claude
committed
0696702
fix(cache): bound a cluster client's topology read like a dial

EricAndrechek
and
claude
committed
c6df13a
Merge branch 'feat/cache-snapshot' into feat/cache-redis

EricAndrechek
and
claude
committed
b861bdb
test(cache): count Redis values so the zero-snapshot case runs

EricAndrechek
and
claude
committed
3c19a85
Merge origin/feat/cache-snapshot into fix/mutation-pipes-uncached

EricAndrechek
and
claude
committed
4c9d951
fix(api): step over heredocs when classifying writes

EricAndrechek
and
claude
committed
05a536d
fix(api): a failed write pipe is never retryable

EricAndrechek
and
claude
committed
0880685
Merge remote-tracking branch 'origin/feat/cache-snapshot' into feat/cache-flat-versions
EricAndrechek
committed
ef59d85
fix(api): lex //, curly quotes and _-led words as ClickHouse does

EricAndrechek
and
claude
committed
0c31dc5
fix(cache): replace connections so a failover reaches the new primary

EricAndrechek
and
claude
committed
c427697
docs(cache): clarify which bumps a no-index tenant absorbs

EricAndrechek
and
claude
committed
4df73f9
docs(cache): CHANGELOG says #262 is part-fixed, not fixed

EricAndrechek
and
claude
committed
95575f2
docs(pipes): a proxy's 5xx is retried too, so a write can run twice

EricAndrechek
and
claude
committed
9b8ed1a
docs(cache): cache.backend exists; Redis key shapes; failover wording

EricAndrechek
and
claude
committed
4752811
docs(cache): a reconnect must fit in the operation timeout

EricAndrechek
and
claude
committed
1f24da5
fix(api): match a statement's leading bareword whole

EricAndrechek
and
claude
committed
98f4a12
Merge feat/cache-flat-versions (#621) into feat/cache-redis (#626)

EricAndrechek
and
claude
committed
e0d7018
Merge the new #626 and #621 heads into feat/cache-redis-wiring

EricAndrechek
and
claude
committed
d60615b
fix(config): cap cache.redis timeout and dial_timeout at 1s

EricAndrechek
and
claude
committed
5b31ce6
fix(cache): review round 1 — one standalone address, e2e stack docs, e2e gate

EricAndrechek
and
claude
committed
41ebc66
docs(dev): list Redis among the cache backend's integration servers

EricAndrechek
and
claude
committed
64f09e8
fix(cache): pin the no-index bump test and fix a "query key" mixup

EricAndrechek
and
claude
committed
558bb23
docs(cache): fix entry-vs-caller query key terms and cachetest coverage

EricAndrechek
and
claude
committed
1febf32
fix(cache): review round 2 — stale docs claims, redisConfig field pin

EricAndrechek
and
claude
committed
5a72724
docs(cache): version_manager.go's own doc carries the query-key/entry-key mixup too

EricAndrechek
and
claude
committed
568f2dd
Merge remote-tracking branch 'origin/feat/cache-snapshot' into feat/cache-flat-versions

EricAndrechek
and
claude
committed
277b5b1
fix(api): classify a WITH-led statement by INSERT INTO alone

EricAndrechek
and
claude
committed
f724033
docs(pipes): what a write pipe skips, bounds and costs

EricAndrechek
and
claude
committed
e8f65ac
fix(cache): trip on rejected credentials; give the probe a dial budget

EricAndrechek
and
claude
committed
bf56403
Merge origin/feat/cache-snapshot into fix/mutation-pipes-uncached

EricAndrechek
and
claude
committed
470cf75
Merge branch 'feat/cache-snapshot' into feat/cache-redis

EricAndrechek
and
claude
committed
f64ce77
docs(agents): list mutationtest in the file structure

EricAndrechek
and
claude
committed
a10ba14
docs(cache): fix the one query-key/entry-key spot the terminology pass missed

EricAndrechek
and
claude
committed
c42b6db
Merge feat/cache-flat-versions (#621) into feat/cache-redis (#626)
EricAndrechek
committed
11a1fc6
Merge the new #626 and #621 heads into feat/cache-redis-wiring
EricAndrechek
committed
f1ab891
docs(cache): match configuration.mdx and deployment.md to #626's fixes

EricAndrechek
and
claude
committed
ce0da48
fix(cache): close the breaker only on a probe write within Timeout

EricAndrechek
and
claude
committed
0eea1cb
fix(api): see a write behind a .-led number or an EXECUTE AS prefix

EricAndrechek
and
claude
committed
e2366d7
Merge the new #626 head (0eea1cbc) into feat/cache-redis-wiring
EricAndrechek
committed
1058677
docs(api): name write pipes as a mutation path, not a second route

EricAndrechek
and
claude
committed
d0af402
docs(cache): match deployment.md to #626's probe-fix (0eea1cbc)

EricAndrechek
and
claude
committed
ecd21c0
test(cache): pin the failover test to one connection

EricAndrechek
and
claude
committed
b3068ab
fix(cache): log the breaker opening once, at WARN

EricAndrechek
and
claude
committed
822aecb
docs(cache): say every breaker opening logs, a failed probe's included

EricAndrechek
and
claude
committed
aad9b1e
docs(cache): correct the Close bound, deferred count and probe wording

EricAndrechek
and
claude
committed
0281ca3
Merge the new #626 head (aad9b1e5) into feat/cache-redis-wiring

EricAndrechek
and
claude
committed
28d4537
Merge #621 (feat/cache-flat-versions) into feat/cache-snapshot

EricAndrechek
and
claude
committed
13418e9
Merge #634 (fix/mutation-pipes-uncached) into feat/cache-snapshot

EricAndrechek
and
claude
committed
088a4b1
Merge #626 and #630 (feat/cache-redis) into feat/cache-snapshot

EricAndrechek
and
claude
committed
2db5027
fix(cache): log a failed probe's reopening at DEBUG, not WARN

EricAndrechek
and
claude
committed
212ad13
fix(cache): log a reopening at its own level when its cause changed

EricAndrechek
and
claude
committed
a7cd351
test(e2e): a write pipe inserts on every call over the shared cache

EricAndrechek
and
claude
committed
71477cb
docs(deployment): write pipes no longer cached; name #394 instead

EricAndrechek
and
claude
committed
79d550e
test(e2e): a failed write pipe answers not retryable

EricAndrechek
and
claude
committed
99dc945