Struct BibLockfile 

pub struct BibLockfile {
    pub question_id: String,
    pub reader: String,
    pub shortlist_hash: String,
    pub content_hash: String,
    pub scitadel_version: String,
    pub algo_hash: String,
    pub format: String,
    pub format_version: String,
    pub generated_at: String,
}

Sidecar JSON written next to the exported .bib (path = <output>.scitadel-bib.lock). One sidecar per output file — per-question scope means several may live in one repo.

Fields

question_id: String

Research question this snapshot was scoped to.

reader: String

Reader identity at snapshot time. Mirrors annotation/star scoping — different readers may produce different shortlists.

shortlist_hash: String

SHA-256 of the lex-sorted paper_id\n list. The drift anchor.

content_hash: String

SHA-256 of the emitted .bib bytes. Cheap re-emit skip.

scitadel_version: String

scitadel binary version that produced this snapshot. Drives the stale exit code when the binary moves forward.

algo_hash: String

Pinned key-generation algorithm hash from ADR-006. Drives the stale exit code when the algorithm itself drifts.

format: String

Output flavor — "bibtex" here. #135 adds "csl-json".

format_version: String

Schema version of this lockfile.

generated_at: String

RFC3339 timestamp of when the snapshot was written. Excluded from byte-determinism guarantees — snapshot-twice-same-bytes holds for everything else.

Implementations

impl BibLockfile

pub fn new_bibtex( question_id: impl Into<String>, reader: impl Into<String>, paper_ids: &[String], content: &str, ) -> Self

Construct a fresh lockfile for a BibTeX snapshot. paper_ids must be the shortlist’s paper IDs; ordering is normalized internally so callers don’t have to think about it.

pub fn new_csl_json( question_id: impl Into<String>, reader: impl Into<String>, paper_ids: &[String], content: &str, ) -> Self

Construct a fresh lockfile for a CSL-JSON snapshot (#135). Same invariants as Self::new_bibtex — ordering normalized, hashes computed over the emitted bytes — only the format discriminant differs so verify can route to the JSON-aware code path.

pub fn to_json(&self) -> Result<String, Error>

Pretty-printed JSON serialization with a trailing newline so editors don’t dirty the file on first open.

pub fn from_json(s: &str) -> Result<Self, Error>

Parse from JSON. Errors propagate the serde failure verbatim.

Trait Implementations

impl Clone for BibLockfile

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 BibLockfile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BibLockfile

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for BibLockfile

impl PartialEq for BibLockfile

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for BibLockfile

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 BibLockfile