Struct FileChange 

pub struct FileChange {
    pub path: String,
    pub operation: String,
    pub timestamp: DateTime<Utc>,
    pub size_bytes: Option<u64>,
    pub line_range: Option<(u32, u32)>,
    pub diff: Option<String>,
}

A single filesystem operation performed by a tool.

The operation field is a free-form string ("read", "create", "modify", …) chosen by the emitting tool. Use the helper constructors below rather than building the struct by hand.

Examples

use codetether_agent::telemetry::FileChange;

let r = FileChange::read("src/main.rs", Some((1, 20)));
assert_eq!(r.operation, "read");
assert!(r.summary().contains("src/main.rs"));

let c = FileChange::create("new.txt", "hello");
assert_eq!(c.size_bytes, Some(5));

Fields

path: String

Filesystem path the tool touched.

operation: String

Operation name ("read" / "create" / "modify" / …).

timestamp: DateTime<Utc>

When the operation happened.

size_bytes: Option<u64>

Post-operation size in bytes, when known.

line_range: Option<(u32, u32)>

(start_line, end_line) the operation applied to, when known.

diff: Option<String>

Unified-diff or free-form diff text, when available.

Implementations

impl FileChange

pub fn read(path: &str, line_range: Option<(u32, u32)>) -> Self

Record a read. line_range is optional but recommended when only a slice of the file was read.

pub fn create(path: &str, content: &str) -> Self

Record file creation. content is used only to compute size_bytes.

pub fn modify( path: &str, old_content: &str, new_content: &str, line_range: Option<(u32, u32)>, ) -> Self

Record a modify with a coarse byte-count diff string.

pub fn modify_with_diff( path: &str, diff: &str, new_size: usize, line_range: Option<(u32, u32)>, ) -> Self

Record a modify with a caller-provided unified diff.

impl FileChange

pub fn summary(&self) -> String

One-line "path (op)" summary suitable for logs and the TUI.

Trait Implementations

impl Clone for FileChange

fn clone(&self) -> FileChange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileChange

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileChange

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FileChange

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

where __S: Serializer,

Serialize this value into the given Serde serializer.