Skip to content

docs(readme): document local state dir + PINAKES_STATE_ROOT#52

Merged
001TMF merged 1 commit into
mainfrom
docs/readme-local-state
Jun 14, 2026
Merged

docs(readme): document local state dir + PINAKES_STATE_ROOT#52
001TMF merged 1 commit into
mainfrom
docs/readme-local-state

Conversation

@001TMF

@001TMF 001TMF commented Jun 14, 2026

Copy link
Copy Markdown
Owner

docs: document local state dir + PINAKES_STATE_ROOT

From the standalone-release decoupling audit (Work Stream A1, verdict: CLEAN — the engine is
already standalone-ready, no decoupling code needed). The audit's one actionable doc nit: the
default local snapshot-store path and its override had no pointer in the main README.

  • Default: <os.UserCacheDir>/pinakes (~/Library/Caches/pinakes on macOS, $XDG_CACHE_HOME/pinakes
    else ~/.cache/pinakes on Linux), auto-created on first run.
  • Override: PINAKES_STATE_ROOT.
  • Reinforces the offline/standalone story: pinakes verify re-runs read this dir with no network.

The audit's other nit (PINAKES_API_KEY future-tier clarity) is already covered at README.md:225,
so no change there. Docs-only; no engine//idl//schema/.

🤖 Generated with Claude Code

…rride

The standalone-decoupling audit (Work Stream A1) flagged that the default local
snapshot-store path (<os.UserCacheDir>/pinakes) and the PINAKES_STATE_ROOT override were
only in code comments + the ebola case study, with no pointer in the main README for a user
to find/back-up/clear local state. Add a short "Local state" section.

Docs only. No engine/idl/schema change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@001TMF 001TMF merged commit 146c54d into main Jun 14, 2026
3 checks passed
@001TMF 001TMF deleted the docs/readme-local-state branch June 14, 2026 01:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant