Enum EpochScope 

pub enum EpochScope {
    All,
    Branch(String),
    Plan(String),
    Workspace(String),
}

What an epoch’s seal actually covers.

Recorded explicitly rather than inferred from which commit list is populated: an epoch of 400 commits is a very different claim depending on whether that means “this plan did 400 things” or “the workspace happened to contain 400 commits at seal time”, and a reader cannot tell those apart after the fact.

Variants

All

Everything reachable from main at seal time. The historical default, and what a .db written before scopes existed deserializes to.

Branch(String)

Everything reachable from one named ref at seal time.

Plan(String)

Only the commits tagged to this epoch while it was the active epoch — i.e. one plan’s own work.

Workspace(String)

Everything in one workspace (namespace) at seal time.

Implementations

impl EpochScope

pub fn as_storage_str(&self) -> String

Storage form: a single flat string, so it round-trips through one TEXT column without a nested encoding.

pub fn from_storage_str(s: &str) -> Self

Parse the storage form. An unknown or malformed value falls back to EpochScope::All — the historical behaviour — so a row written by a newer version can never make an older one fail to read its own store.

pub fn seal_ref(&self) -> Option<&str>

The ref whose reachable set this scope seals, if it is ref-shaped. Plan returns None — it is defined by tagged commits, not a walk.

Trait Implementations

impl Clone for EpochScope

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EpochScope

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

Formats the value using the given formatter.

impl Default for EpochScope

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EpochScope

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for EpochScope

impl PartialEq for EpochScope

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for EpochScope

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for EpochScope