Struct Ledger 

pub struct Ledger {
    pub schema_version: u32,
    pub prefix: String,
    pub style: Style,
    pub active: Option<String>,
    pub queue: Vec<QueuedTask>,
    pub archive: Vec<ArchivedTask>,
    pub horizon: Vec<HorizonTask>,
}

One repository’s work queue.

Fields

schema_version: u32

Ledger schema version, the one this qctl writes and accepts. Increment only with a coordinated schema and ledger migration.

prefix: String

Stable id prefix for this repository. Never encodes priority.

style: Style

How this ledger is written. A file that says nothing here gets the defaults, which are the shape qctl already wrote.

active: Option<String>

The one task currently being executed, or null when work is intentionally paused.

queue: Vec<QueuedTask>

Pending work in priority order. The order is the priority. Queue, archive, and horizon partition one globally unique, continuous id corpus.

archive: Vec<ArchivedTask>

Completed or deliberately dropped work, newest first. Archived ids are never reused and remain part of the global task corpus.

horizon: Vec<HorizonTask>

Mapped work that is not on the short-term queue: research, evaluations, or deferred items without a start condition. File order is not priority, active must never name a horizon id, and each id still belongs to the same global task corpus.

Trait Implementations

impl Debug for Ledger

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Ledger

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Ledger

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for Ledger

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Validate for Ledger

type Context = ()

A user-provided context.

fn validate_into( &self, __garde_user_ctx: &Self::Context, __garde_path: &mut dyn FnMut() -> Path, __garde_report: &mut Report, )

Validates Self, aggregating all validation errors into Report.

fn validate(&self) -> Result<(), Report>

where Self::Context: Default,

Validates Self, returning an Err with an aggregate of all errors if the validation failed.

fn validate_with(&self, ctx: &Self::Context) -> Result<(), Report>

Validates Self, returning an Err with an aggregate of all errors if the validation failed.