Struct SpecSnapshot 

pub struct SpecSnapshot {
    pub timestamp: SystemTime,
    pub files: HashMap<PathBuf, FileMetadata>,
}

A snapshot of spec files at a point in time.

This struct captures the state of .md files in relevant directories before spawning a Claude session, allowing detection of new files afterward.

Fields

timestamp: SystemTime

The timestamp when this snapshot was taken.

files: HashMap<PathBuf, FileMetadata>

Map of file paths to their metadata at snapshot time.

Implementations

impl SpecSnapshot

pub fn capture() -> Result<Self>

Create a new snapshot by scanning the specified directories for .md files.

Scans both:

• ~/.config/autom8/<project>/pdr/ (config directory)
• Current working directory

Directories that don’t exist are silently skipped (resulting in an empty contribution to the snapshot from that location).

pub fn len(&self) -> usize

Returns the number of files in this snapshot.

pub fn is_empty(&self) -> bool

Returns true if the snapshot contains no files.

pub fn contains(&self, path: &PathBuf) -> bool

Check if a file path exists in this snapshot.

pub fn get(&self, path: &PathBuf) -> Option<&FileMetadata>

Get the metadata for a file path, if it exists in the snapshot.

pub fn detect_new_files(&self) -> Result<Vec<PathBuf>>

Detect new spec files by comparing current state against this snapshot.

Scans the same directories (config spec/ and current working directory) and returns paths to files that are either:

• Not present in the original snapshot (newly created)
• Present but modified after the snapshot timestamp (modified during session)

Returns a sorted list of canonical paths to new/modified .md files.

Trait Implementations

impl Clone for SpecSnapshot

fn clone(&self) -> SpecSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpecSnapshot

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

Formats the value using the given formatter.