Struct Ledger 

pub struct Ledger {
    pub paths: EddaPaths,
    /* private fields */
}

The append-only event ledger (SQLite backend).

Fields

paths: EddaPaths

Implementations

impl Ledger

pub fn open(repo_root: impl Into<PathBuf>) -> Result<Self>

Open an existing workspace. Fails if .edda/ does not exist.

pub fn open_or_init(repo_root: impl Into<PathBuf>) -> Result<Self>

Open a workspace, auto-initializing .edda/ if missing.

Use this for read-path consumers (e.g. edda watch) that should work without requiring the user to run edda init first.

This is a lightweight init — it only creates the ledger directory layout and SQLite DB. Config files (policy.yaml, actors.yaml) and bridge hooks are NOT created; those require edda init.

pub fn ensure_initialized(repo_root: impl Into<PathBuf>) -> Result<()>

Ensure .edda/ and ledger exist, without returning a Ledger handle.

Use this when you only need the side effect (workspace creation) and will open the ledger separately later.

pub fn open_path(repo_root: &Path) -> Result<Self>

Convenience: open from a Path ref (avoids Into ambiguity).

pub fn head_branch(&self) -> Result<String>

Read the current HEAD branch name.

pub fn set_head_branch(&self, name: &str) -> Result<()>

Write the HEAD branch name.

pub fn append_event(&self, event: &Event) -> Result<()>

Append an event to the ledger. Append-only (CONTRACT LEDGER-02).

pub fn last_event_hash(&self) -> Result<Option<String>>

Get the hash of the last event, or None if the ledger is empty.

pub fn iter_events(&self) -> Result<Vec<Event>>

Read all events in the ledger.

pub fn branches_json(&self) -> Result<Value>

Read branches.json content.

pub fn set_branches_json(&self, value: &Value) -> Result<()>

Write branches.json content.

pub fn active_decisions( &self, domain: Option<&str>, key_pattern: Option<&str>, ) -> Result<Vec<DecisionRow>>

Query active decisions, optionally filtered by domain or key pattern.

pub fn decision_timeline(&self, key: &str) -> Result<Vec<DecisionRow>>

All decisions for a key (active + superseded), ordered by time.

pub fn domain_timeline(&self, domain: &str) -> Result<Vec<DecisionRow>>

All decisions for a domain (active + superseded), ordered by time.

pub fn list_domains(&self) -> Result<Vec<String>>

Distinct domain values from active decisions.

pub fn find_active_decision( &self, branch: &str, key: &str, ) -> Result<Option<DecisionRow>>

Find the active decision for a specific key on a branch.