Struct WorkingSetEntry 

pub struct WorkingSetEntry {
    pub path: PathBuf,
    pub tokens: usize,
    pub access_count: u32,
    pub last_access_turn: u32,
    pub added_at_turn: u32,
    pub pinned: bool,
    pub label: Option<String>,
    pub intended_hash: Option<[u8; 32]>,
}

A file entry in the working set

Fields

path: PathBuf

File path.

tokens: usize

Estimated token count for this file.

access_count: u32

Number of times this file has been accessed.

last_access_turn: u32

Turn number when this file was last accessed.

added_at_turn: u32

Turn number when this file was added.

pinned: bool

Whether this file is pinned (immune to eviction).

label: Option<String>

Optional label for categorizing the entry.

intended_hash: Option<[u8; 32]>

SHA-256 of the most recent content this agent intended to write to path, set by write_file after its read-back check succeeds.

Used by the validation loop to detect post-validation clobber: if the file on disk no longer hashes to intended_hash at finalization time, another writer has overwritten our content and the agent must NOT report Success: true.

None for files that were only read, or for entries added before any write occurred.

Implementations

impl WorkingSetEntry

pub fn new(path: PathBuf, tokens: usize, current_turn: u32) -> Self

Create a new working set entry at the given turn.

pub fn with_label(self, label: impl Into<String>) -> Self

Attach a label to this entry (builder pattern).

pub fn pinned(self) -> Self

Mark this entry as pinned (builder pattern).

Trait Implementations

impl Clone for WorkingSetEntry

fn clone(&self) -> WorkingSetEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkingSetEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WorkingSetEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for WorkingSetEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.