Struct ChunkMetadata 

pub struct ChunkMetadata {
    pub source_type: String,
    pub path: Option<String>,
    pub commit: Option<String>,
    pub author: Option<String>,
    pub date: Option<String>,
    pub base_offset: usize,
    pub base_line: usize,
    pub mtime_ns: Option<u64>,
    pub size_bytes: Option<u64>,
}

Metadata that tracks the source location for a scanned chunk.

Examples

use keyhog_core::ChunkMetadata;

let metadata = ChunkMetadata {
    source_type: "git-diff".into(),
    path: Some("src/lib.rs".into()),
    commit: Some("abc123".into()),
    author: Some("Dev".into()),
    date: Some("2026-03-26T00:00:00Z".into()),
    ..Default::default()
};

assert_eq!(metadata.source_type, "git-diff");

Fields

source_type: String

path: Option<String>

commit: Option<String>

author: Option<String>

date: Option<String>

base_offset: usize

base_line: usize

Number of lines that precede base_offset in the original file - the line-number analog of base_offset. Zero for whole-file chunks (single-pass mmap, stdin, http, git diffs). Non-zero only when a source slices one file into multiple chunks (the filesystem >window_size windowed path), where each window after the first starts partway through the file. The scanner computes a match’s line number within the chunk text and adds this base so the reported line is the absolute file line, not the per-window one - exactly mirroring how base_offset makes the byte offset absolute. Without it, a secret on line 584307 of a 70 MiB file was reported at the window-local line (e.g. line 2), making findings impossible to locate.

mtime_ns: Option<u64>

File mtime in nanoseconds since UNIX epoch, when the source can surface it cheaply (filesystem walks). Optional because non-fs sources (stdin, http, git diffs) don’t have a meaningful mtime. Populated to drive the merkle-index metadata fast-path.

size_bytes: Option<u64>

File size in bytes, when known cheaply at chunk-production time. Same shape and rationale as mtime_ns.

Trait Implementations

impl Clone for ChunkMetadata

fn clone(&self) -> ChunkMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChunkMetadata

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

Formats the value using the given formatter.

impl Default for ChunkMetadata

fn default() -> ChunkMetadata

Returns the “default value” for a type.

impl Serialize for ChunkMetadata

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

where __S: Serializer,

Serialize this value into the given Serde serializer.