Skip to content

docs: add ADR 0009 for static-context cache-first local persistence #75

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jonathannorris wants to merge 39 commits into
base: main
Choose a base branch
from
+299 −0
Open

docs: add ADR 0009 for static-context cache-first local persistence #75

Changes from all commits
Commits
Show all changes
39 commits
Select commit Hold shift + click to select a range
2ae6ebe
Add ADR for offline local storage cache
jonathannorris Mar 6, 2026
7584929
Renumber local storage ADR to 0009
jonathannorris Mar 6, 2026
db1f682
docs(adr): refine static-context local persistence proposal
jonathannorris Mar 7, 2026
6ece5e5
docs(adr): clarify fallback semantics in ADR 0009
jonathannorris Mar 7, 2026
ba6c4c7
docs(adr): clarify cache key guidance in ADR 0009
jonathannorris Mar 7, 2026
9672519
docs(adr): add disableLocalCache option to ADR 0009
jonathannorris Mar 7, 2026
6ef2020
docs(adr): simplify cache key to hash(targetingKey) in ADR 0009
jonathannorris Mar 13, 2026
2e8c2bd
docs(adr): add CACHED evaluation reason and remove resolved open ques…
jonathannorris Mar 13, 2026
98b2c8a
docs(adr): strengthen fallback language to must not in ADR 0009
jonathannorris Mar 13, 2026
82c3d52
docs(adr): remove platform constraint from negative consequences
jonathannorris Mar 13, 2026
8d3d0d1
docs(adr): make security/privacy consequence more concrete
jonathannorris Mar 13, 2026
1129060
docs(adr): remove storage model implementation details from ADR 0009
jonathannorris Mar 13, 2026
a7ad620
docs(adr): clean up implementation notes and mermaid diagram
jonathannorris Mar 13, 2026
f69127f
docs(adr): rewrite ADR 0009 for cache-first initialization
jonathannorris Mar 19, 2026
a2e7090
docs(adr): add cache TTL as open question in ADR 0009
jonathannorris Mar 19, 2026
f5603ff
docs(adr): improve precision of provider lifecycle semantics in ADR 0009
jonathannorris Mar 19, 2026
261b512
docs(adr): clear persisted cache on auth/config errors in ADR 0009
jonathannorris Mar 20, 2026
3069d46
docs(adr): clarify background refresh cancellation and first cold sta…
jonathannorris Mar 30, 2026
e135a79
docs(adr): add cache key namespace as open question in ADR 0009
jonathannorris Mar 31, 2026
392126d
docs(adr): refine cache namespace open question to use auth token hash
jonathannorris Mar 31, 2026
ed13ec0
Revert "refactor: make endpoint.origin optional, default to OFREP bas…
jonathannorris Apr 10, 2026
5d79478
chore: add a requirement to have an optional init option in providers…
jsalaber Apr 13, 2026
c8cfb28
docs(adr): keep persisted cache on auth errors, rely on TTL for expiry
jonathannorris Apr 13, 2026
3a52351
docs(adr): recommend cacheKeyPrefix for multi-provider namespacing
jonathannorris Apr 13, 2026
e5bed69
docs(adr): implement cacheKeyPrefix for multi-provider namespacing
jonathannorris Apr 13, 2026
1a35195
docs(adr): restore cacheKeyPrefix open question with answer
jonathannorris Apr 13, 2026
85b5aaf
docs(adr): add version field to example and rename file to kebab-case
jonathannorris Apr 13, 2026
adac228
chore: reset non-ADR-0009 files to main
jonathannorris Apr 13, 2026
dff6881
docs(adr): use delimiter in cacheKeyPrefix hash to prevent collisions
jonathannorris Apr 15, 2026
752bf76
docs(adr): add implementation note for storage write failures
jonathannorris Apr 15, 2026
a16acdb
docs(adr): introduce cacheMode option with network-first mode for SPAs
jonathannorris Apr 22, 2026
fe624b2
docs(adr): rename cache-first to local-cache-first for clarity
jonathannorris Apr 22, 2026
4b77865
docs(adr): simplify network-first description to reference existing b…
jonathannorris Apr 22, 2026
e84df06
docs(adr): explain network-first as existing behavior plus offline fa…
jonathannorris Apr 22, 2026
2806037
docs(adr): add section title and description before initialization di…
jonathannorris Apr 22, 2026
cdfab0e
docs(adr): clarify TTL-expired entries must not be served
jonathannorris Apr 22, 2026
8c4d8e0
docs(adr): split initialization sequence diagram into three smaller d…
jonathannorris Apr 22, 2026
5b5ce64
docs(adr): reframe cache clearing as implementation detail, focus on …
jonathannorris Apr 22, 2026
05364b5
docs(adr): require both logging and PROVIDER_ERROR emit on auth/confi…
jonathannorris Apr 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Loading