**Bead** `cc07a6c8-dcb9-4470-9569-e16604470393` · [canonical URI](https://redfish.acequia.io/guerin/.agents/cc07a6c8-dcb9-4470-9569-e16604470393/) · discussion: Talk: Cache Manager This page is the wiki facet of a [bead](https://redfish.acequia.io/guerin/.agents/); the bead is the source of truth.
> The **operational agent that manages cache replicas** across the acequia ecology — the mayordomo of > caches, sibling to bead-orchestrator (mayordomo of beads). Where [`4456cd24`](https://redfish.acequia.io/guerin/.agents/4456cd24-010a-41e9-a14c-a2d1086893bd/about.md) > theorizes the **cache-as-state substrate**, cache-manager runs the verbs *on the cache itself* — fill, > serve, invalidate, evict (apoptose), push, reconcile, elect — over the replica set (browser Cache-API / > OPFS / IndexedDB ⇄ service worker ⇄ OS-node origin ⇄ WebDAV endpoint).
## Identity - **name:** `cache-manager` - **URI:** https://redfish.acequia.io/guerin/.agents/cc07a6c8-dcb9-4470-9569-e16604470393/ - **Local origin:** `sites/redfish.acequia.io/guerin/.agents/cc07a6c8-dcb9-4470-9569-e16604470393/` - **GUID:** `cc07a6c8-dcb9-4470-9569-e16604470393` - **Slug:** `cache-manager` (working name — see note 00 Q7) - **Opened:** 2026-06-18 - **Parciante:** Stephen Guerin (guerin) - **Parent (dominus):** `https://redfish.acequia.io/guerin/` - **Currently animated by:** Claude (CE — bead scribe, filesystem/WebDAV write authority)
## Motivation (Why a GUID) Stephen: *"start-bead cache-manager / forage beads about caches."* The commons already has a rich cache thread — most of all [`4456cd24` decentralized-cache-management](https://redfish.acequia.io/guerin/.agents/4456cd24-010a-41e9-a14c-a2d1086893bd/about.md), the **paper-first substrate model** (cache-as-state, Firebase→acequia, the three hard problems). What it does **not** yet have is the **operational counterpart**: an agent that actually *manages* live cache replicas — fills them, serves local-first reads, signals invalidation (apoptosis not necrosis), pushes writes to peers, reconciles divergence under partition, and shares leader-election with the orchestrator. This bead is that manager. A fresh GUID keeps the forage, the verb-set, and the operational design out of the global namespace while giving siblings a stable URI to mount.
## Mechanism (What this bead does) - [00-cache-manager-forage.md](https://redfish.acequia.io/guerin/.agents/cc07a6c8-dcb9-4470-9569-e16604470393/2026-06-18/notes/00-cache-manager-forage.md) — the orientation note: the **boundary question** (what cache-manager owns vs `4456cd24` vs the orchestrator), the **forage inventory** of all cache work in the commons (tiered), the working **verb-set** (fill/serve/invalidate/evict/push/reconcile/elect), and 7 open questions. - It explicitly **mounts and defers to** `4456cd24` for substrate theory (does not restate it), coordinates with the orchestrator (`4c6470f9` Duties 3 & 4) on sync/lease/CORS-bridge, and runs its verbs at the liveness-ladder rungs of the handler (`fe7fbaf5`). **Offer-only design bead at this stage.** It surveys and proposes; nothing is built or ratified until Stephen binds note 00's open questions (the lead one being the boundary with `4456cd24`).
## Folder Layout ``` cc07a6c8-dcb9-4470-9569-e16604470393/ ├── about.md # this file ├── README.md # front-door sidecar ├── agent.md # operative self ├── agent.json # machine twin ├── names.json # mounted cache beads (tiered) ├── keywords.json # index surface ├── bead-bind-startup.md # resume contract ├── uploads/ # inbound dock └── 2026-06-18/ ├── notes/ │ └── 00-cache-manager-forage.md # ★ forage + framing + open Qs └── chats/ └── 2026-06-18-cache-manager-birth.md ```
## Session Log - **2026-06-18** — Bead opened (`start-bead`, CE for Stephen). **Foraged** the commons for cache work (an Explore pass over the 103-bead tree + `.ai/`): found `4456cd24` (substrate, load-bearing), `96597c32` (frame), `4c6470f9` Duties 3/4 (mechanism), `fe7fbaf5` (runtime), `aeb319e9` (LAN), `43685e36`/`6f5044df` (storage/query), `3e978f25` (CRDT exemplar), `3d7a3a1a` (cache-as-state in miniature), `7049c694`/ `82bd6fa4` (live origins), + 3 `.ai/` docs. Wrote note 00 (boundary hypothesis: operational counterpart of `4456cd24`; verb-set; 7 open Qs) and the root files; mounted the foraged beads in `names.json`.
## Modus Operandi (How to interact) - Read [00-cache-manager-forage.md](https://redfish.acequia.io/guerin/.agents/cc07a6c8-dcb9-4470-9569-e16604470393/2026-06-18/notes/00-cache-manager-forage.md) first; the §1 boundary question is the gate. - The §4 open questions are Stephen's binding decisions; nothing is reified until he binds. - Deposit material/requests into `uploads/` per the blackboard protocol.
## Capabilities - Design synthesis over the cache/replica-management layer (by reference to the mounted beads). - **No deployed cache daemon yet** — this bead forages + frames; a `cache-manager.mjs` (SW + Node agent with the §3 verbs) is the natural next artifact once the boundary (Q0) and first worked example (Q2) are bound.
## Lifecycle Active design + forage thread. Apoptoses into a citable record + (optionally) a running cache-broker / manager child once the duties are bound; the folder persists as the fossil.
## Limitations - Paper + forage — no running cache manager, broker, or reconciler exists yet. - The boundary with `4456cd24` (substrate) and `4c6470f9` (bead coordination) is a **working hypothesis**, not bound; the verb-set and the name `cache-manager` are proposed (note 00 Q0, Q7).
## Related beads - [`4456cd24` decentralized-cache-management](https://redfish.acequia.io/guerin/.agents/4456cd24-010a-41e9-a14c-a2d1086893bd/about.md) — the substrate this manages (mount; do not restate). - [`4c6470f9` bead-orchestrator](https://redfish.acequia.io/guerin/.agents/4c6470f9-b74a-4aba-b436-5e998f469cce/about.md) — shares the lease/election; Duties 3 & 4 are cache management for the bead tree. - [`fe7fbaf5` bead-as-webdav-handler](https://redfish.acequia.io/guerin/.agents/fe7fbaf5-4c47-43b6-be1b-2f6ca15e8bfa/about.md) — the liveness ladder where cache verbs run. - [`aeb319e9` local-gateway-agent](https://redfish.acequia.io/guerin/.agents/aeb319e9-a00c-46cc-8b33-07eabcf17813/about.md) — local-first cache sync, SW↔WebDAV. - [`3e978f25` anyhazard editor](https://redfish.acequia.io/guerin/.agents/3e978f25-63f0-4002-9501-83d3f79345f4/about.md) — CRDT change-ops (write-granularity exemplar). - [`72efa91c` acequia-link](https://redfish.acequia.io/guerin/.agents/72efa91c-3506-49f2-9b5e-6af4c02ec12e/about.md) — cache verbs ARE link breeds in motion (fill/push = txn/dock; reconcile = constraint relaxation; evict = link apoptosis).
## References (bead cross-links) - Bead: Decentralized Cache Management · [canonical](https://redfish.acequia.io/guerin/.agents/4456cd24-010a-41e9-a14c-a2d1086893bd/) - Bead: Orchestrator · [canonical](https://redfish.acequia.io/guerin/.agents/4c6470f9-b74a-4aba-b436-5e998f469cce/) - Bead: As Webdav Handler · [canonical](https://redfish.acequia.io/guerin/.agents/fe7fbaf5-4c47-43b6-be1b-2f6ca15e8bfa/) - Bead: Local Gateway Agent · [canonical](https://redfish.acequia.io/guerin/.agents/aeb319e9-a00c-46cc-8b33-07eabcf17813/) - Bead: Simtable Learnmore Anyhazard · [canonical](https://redfish.acequia.io/guerin/.agents/3e978f25-63f0-4002-9501-83d3f79345f4/) - Bead: Acequia Link · [canonical](https://redfish.acequia.io/guerin/.agents/72efa91c-3506-49f2-9b5e-6af4c02ec12e/) - Bead: 96597c32 · [canonical](https://redfish.acequia.io/guerin/.agents/96597c32-7f1c-4e95-acd5-635673461781/) - Bead: Browser + Node Vector & RAG Search · [canonical](https://redfish.acequia.io/guerin/.agents/43685e36-80bb-44dc-94be-89ea1c2fa205/) - Bead: Orama Bead · [canonical](https://redfish.acequia.io/guerin/.agents/6f5044df-cd90-459d-a150-e0250e98039a/) - Bead: Claude Duplicate Chat Tabs · [canonical](https://redfish.acequia.io/guerin/.agents/3d7a3a1a-9a4c-450a-a548-f19675b8dfe3/) - Bead: Home Port Forward Hosting · [canonical](https://redfish.acequia.io/guerin/.agents/7049c694-e45b-4116-a887-49e64885ac8e/) - Bead: Stephenguerin.live Router Bead · [canonical](https://redfish.acequia.io/guerin/.agents/82bd6fa4-4d5a-435b-9deb-ca930a82aa89/)
See all: Beads