aboutsummaryrefslogtreecommitdiff
path: root/docs/design/cache-helper-design.org
Commit message (Collapse)AuthorAgeFilesLines
* docs(design): add Phase 5 cache helper design addendumCraig Jennings2026-05-101-0/+165
Per Phase 5 step 1 of utility-consolidation. Specifies the cache API to extract from org-agenda-config and org-refile-config (both have parallel TTL+building-guard implementations today). Documents the API: `cj/cache-make', `cj/cache-valid-p', `cj/cache-value-or-rebuild', `cj/cache-building-p', `cj/cache-invalidate'. Out-of-scope: modeline VC cache (buffer-local + key-based, not TTL). Per the spec, that's a future round. Documents the migration order (agenda first, refile second), test plan for the helper, and risk notes (cache-hit logging preservation, building-flag leak guard, async-timer interaction).