Struct KernelDirOutcome 

#[non_exhaustive]
pub struct KernelDirOutcome {
    pub dir: PathBuf,
    pub cache_hit: Option<KernelDirCacheHit>,
    pub is_dirty: bool,
}

Result bundle from resolve_kernel_dir_to_entry.

Bundles the resolved boot-image directory, the cache-hit signal, and the dirty-tree flag so callers do not have to re-run gix::open to learn whether the build was reproducible. The dirty flag is the single source of truth for downstream label decoration (crate::test_support::sanitize_kernel_label’s upstream caller appends _dirty so test reports show the run used a non-reproducible build).

non_exhaustive so a future field (e.g. cache miss vs cache store-failed distinction) can land without breaking external destructuring. Construction goes through field literals at the definition site only — every external consumer reads via the public field accessors.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

dir: PathBuf

Directory that holds the resolved boot image.

• Clean tree: cache entry directory under one of the local-{hash7}-{arch}[-cfg{user_config}]-kc{suffix} or local-unknown-{path_hash}-{arch}-kc{suffix} shapes (see crate::fetch::compose_local_cache_key); boot image at <dir>/<image_name>.
• Dirty tree: canonical source-tree directory, boot image at <dir>/arch/x86/boot/bzImage (x86_64) or <dir>/arch/arm64/boot/Image (aarch64) — the kernel build-tree arch subdir (x86/arm64), not the arch_info() name (x86_64/aarch64).

Both shapes are valid inputs to crate::kernel_path::find_image_in_dir.

cache_hit: Option<KernelDirCacheHit>

Some when the resolution short-circuited on a cache hit — the build pipeline did not run. None when the build pipeline ran (clean-tree miss-then-build OR dirty-tree build-without-store). is_dirty distinguishes the two None cases.

is_dirty: bool

Whether the source tree was non-reproducible. Union of two signals:

• Acquire-time inspection by crate::fetch::local_source (uncommitted modifications before the build started, OR a non-git tree that has no commit hash to record).
• Post-build re-check from crate::fetch::inspect_local_source_state (worktree edited, branch flipped, or commit landed during make).

Either signal flips this to true. Always false on a cache hit — the cache lookup gate requires a clean tree at acquire time and the build pipeline does not run.

Trait Implementations

impl Clone for KernelDirOutcome

fn clone(&self) -> KernelDirOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KernelDirOutcome

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

Formats the value using the given formatter.