Struct Manifest 

pub struct Manifest {

    pub schema_version: u32,
    pub codelore_version: String,
    pub gix_version: String,
    pub arrow_version: String,
    pub duckdb_version: String,
    pub run_started_at: String,
    pub repo_path: String,
    pub head_sha: String,
    pub cache_key_hash: String,
    pub after_date: Option<String>,
    pub before_date: Option<String>,
    pub analysis: String,
    pub min_revs: u32,
    pub min_shared_revs: u32,
    pub min_coupling_pct: u8,
    pub max_changeset_size: u32,
    pub fisher_significance: f64,
    pub include_merges: bool,
    pub age_time_now: Option<String>,
    pub merge_handling: String,
    pub complexity_sample: String,
    pub rust_version: String,
    pub target_triple: String,
    pub grammars: BTreeMap<String, String>,
    pub options: Value,
    pub corpus_vintage: Option<String>,
    pub defect_vintage: Option<String>,
}

Fields

schema_version: u32

Provenance-manifest schema version. See MANIFEST_SCHEMA_VERSION for the bump contract.

codelore_version: String

gix_version: String

arrow_version: String

duckdb_version: String

run_started_at: String

repo_path: String

head_sha: String

Resolved HEAD SHA of the analysed repository at run time. Empty string when the fact store could not surface a HEAD commit (degenerate case; should not happen on a successful ingest). Reproducibility-critical: without this an auditor can’t confirm two runs analysed the same code state.

cache_key_hash: String

Hex-encoded SHA-256 of the persistent cache key for this run. Lets downstream tooling join provenance to cache entries on disk without recomputing the key.

after_date: Option<String>

before_date: Option<String>

analysis: String

min_revs: u32

min_shared_revs: u32

min_coupling_pct: u8

max_changeset_size: u32

fisher_significance: f64

include_merges: bool

age_time_now: Option<String>

merge_handling: String

complexity_sample: String

rust_version: String

Workspace MSRV at build time. Pinned by RUST_VERSION in this module; mirrors [workspace.package].rust-version in the root Cargo.toml.

target_triple: String

Build target triple (<arch>-<vendor>-<os>-<env>). Reproducibility check for cross-built binaries.

grammars: BTreeMap<String, String>

Tree-sitter grammar pins as compiled into this build. Map from grammar crate name to its Cargo.toml version pin. A silent grammar bump can shift cognitive-complexity outputs without surfacing in any other manifest field.

options: Value

Complete canonical JSON of every Options field at run time. Source of truth for reproducibility — auto-derives so newly-added Options fields propagate without per-field maintenance. The flat fields above remain for human readability and grep-ability.

corpus_vintage: Option<String>

Vintage string of the corpus-calibration artifact active for this run (e.g. "world-2026-07"). Absent (None, omitted from JSON) when no calibration artifact was active — no --calibration file was passed and the embedded world artifact is still the placeholder.

defect_vintage: Option<String>

Vintage string of the own-repo defect-calibration artifact active for this run (e.g. "defects-2026-07-15"). Absent (None, omitted from JSON) when no --defect-calibration file was passed.

Implementations

impl Manifest

pub fn capture(db: &FactsDb, opts: &Options, analysis: &str) -> Result<Self>

Capture the manifest from a fact store + options + analysis name. _db is currently unused but reserved for reading provenance table values.

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

Serialize the manifest to pretty JSON.

Trait Implementations

impl Debug for Manifest

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

Formats the value using the given formatter.

impl Serialize for Manifest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.