# `ReqManagedAgents.Provisioner.Store.File`
[🔗](https://github.com/cash-mckeeman/req_managed_agents/blob/v0.13.0/req_managed_agents/lib/req_managed_agents/provisioner/store/file.ex#L1)

Persistent JSON-file store: provision handles and tags survive OS-process
restarts (CLI tools, mix tasks, cron). One flat JSON object per file;
writes are atomic (temp file + rename). **Single-writer assumption**: this
is a workstation/task-runner store, not a concurrent-fleet store. A missing
or corrupt file is treated as empty (with a logged warning) — the durable
provider resources are recoverable regardless.

Values must be JSON-encodable (provision handles are structs that encode to
a plain three-field JSON object; atom keys round-trip as strings, which is
fine for handle maps read back via string-keyed access — store consumers in
this library only ever compare whole values or read string keys).

---

*Consult [api-reference.md](api-reference.md) for complete listing*
