Struct RepoState 

pub struct RepoState {
    pub root: PathBuf,
    pub git_event: GitEvent,
    pub base_ref: String,
    pub staged_files: Vec<PathBuf>,
}

Snapshot of repo metadata passed to every check execution.

base_ref is the merge-base ref between HEAD and the upstream tracking branch — the “branch divergence point” diff-aware tools (pre-commit run --from-ref, fallow audit --base) want. The gate runtime exposes it to shell checks via the KLASP_BASE_REF env var; sources that talk to other check tools (named recipes in v0.2, subprocess plugins in v0.3) read it directly off this struct.

Falls back to HEAD~1 when no upstream is configured (a fresh checkout, a detached HEAD, or a branch that has never been pushed). The fallback is best-effort — diff-aware tools that don’t recognise the ref simply lint the whole tree, which is the same behaviour they’d have without klasp.

staged_files carries the absolute paths of files in the current group’s scope when running in monorepo mode (i.e. the subset of staged files that belong to the klasp.toml group that owns this invocation). An empty Vec means “no scoping; the check sees the whole repo” — this is the back-compat value used by the single-config fallback path and by callers that do not dispatch per-group. Per-source consumption of staged_files for fine-grained scoping is deferred to issue #34 (rayon / named recipes); the field is present now so that data is available to checks without a further struct-breaking change.

Fields

root: PathBuf

git_event: GitEvent

base_ref: String

staged_files: Vec<PathBuf>

Staged files scoped to this group’s klasp.toml. Empty = whole-repo (single-config fallback or unscoped callers).

Trait Implementations

impl Clone for RepoState

fn clone(&self) -> RepoState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RepoState

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

Formats the value using the given formatter.