Struct JsonFilePersistence 

pub struct JsonFilePersistence { /* private fields */ }

On-disk JSON-sidecar persistence.

Records are stored as a JSON array on a single file under the configured path. Reads parse the whole file; writes serialize the whole array. This is intentionally simple — declared plugins are metadata, not throughput-sensitive.

File format (proposal §9.7 schema, JSON-encoded):

[
  {
    "qname": "mycorp.fullName",
    "kind": "Function",
    "body": "$first + ' ' + $last",
    "signature_json": "{...}",
    "dependencies": [],
    "declared_by": "alice",
    "active": true
  }
]

The cutover to _DeclaredPlugin system-label persistence (proposal §9.7) leaves this struct unchanged — the wire schema is identical.

Implementations

impl JsonFilePersistence

pub fn new(path: PathBuf) -> Self

Construct a persistence backend at the exact path.

The file is created on first write. If it does not exist at construction time, Self::load_all returns an empty vector. The path is used verbatim (via SystemSidecar::at_path) so existing declared_plugins.json files keep loading across an upgrade.

Trait Implementations

impl Debug for JsonFilePersistence

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Persistence for JsonFilePersistence

fn save(&self, plugin: &DeclaredPlugin) -> Result<(), PersistenceError>

Persist a freshly-declared plugin record.

fn delete(&self, qname: &str) -> Result<(), PersistenceError>

Remove a previously persisted record by qname.

fn load_all(&self) -> Result<Vec<DeclaredPlugin>, PersistenceError>

Replay every persisted declaration (in any order — callers must topologically sort if dependency ordering matters).