Struct FileChange 

pub struct FileChange {
    pub path: PathBuf,
    pub kind: ChangeKind,
    pub content: Option<Vec<u8>>,
    pub file_id: Option<FileId>,
    pub blob: Option<GitOid>,
}

A single file change captured from a workspace.

For Added and Modified changes, content holds the new file bytes. For Deleted changes, content is None.

file_id is the stable FileId assigned when the file was created. It survives renames and modifications, enabling rename-aware merge (§5.8). None if FileId tracking was not available at collect time.

blob is the git blob OID for the new content (computed via git hash-object). Present for Added and Modified changes when the collect step had access to the git repo. Enables O(1) hash-equality checks in the resolve step without comparing raw bytes.

Fields

path: PathBuf

Path relative to the workspace root (and to the repo root).

kind: ChangeKind

Type of change.

content: Option<Vec<u8>>

New file content (None for deletions).

file_id: Option<FileId>

Stable file identity that persists across renames (§5.8).

None only for legacy artifacts and explicit test fixtures.

blob: Option<GitOid>

Git blob OID for the new content (present for Add/Modify; None for Delete and for changes collected without git access).

When populated, the resolve step uses OID equality instead of byte comparison for hash-equality checks, which is both faster and avoids loading content into memory.

Implementations

impl FileChange

pub const fn new( path: PathBuf, kind: ChangeKind, content: Option<Vec<u8>>, ) -> Self

Create a new FileChange without FileId or blob OID metadata.

Suitable for explicit legacy/test fixtures. Production collect paths should prefer FileChange::with_identity.

pub const fn with_identity( path: PathBuf, kind: ChangeKind, content: Option<Vec<u8>>, file_id: Option<FileId>, blob: Option<GitOid>, ) -> Self

Create a new FileChange with full identity metadata.

Preferred constructor for Phase 3+ code paths where file_id and blob OID are available from the workspace’s FileId map and git object store.

pub const fn is_deletion(&self) -> bool

Returns true if this change is a deletion.

pub const fn has_content(&self) -> bool

Returns true if this change adds or modifies a file (has content).

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 PartialEq for FileChange

fn eq(&self, other: &FileChange) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for FileChange

impl StructuralPartialEq for FileChange