Struct ChangeSet 

pub struct ChangeSet {
    pub changeset_id: Uuid,
    pub target_uri: String,
    pub kind: ChangeKind,
    pub diff_content: DiffContent,
    pub preview_ref: Option<String>,
    pub risk_flags: Vec<String>,
    pub commit_intent: CommitIntent,
    pub created_at: DateTime<Utc>,
    pub content_hash: String,
}

A single staged mutation — the fundamental unit of the review system.

Every change an agent makes flows through this type, whether it’s a file edit, email draft, or database write.

Fields

changeset_id: Uuid

Unique identifier for this changeset.

target_uri: String

The resource being changed (e.g., “fs://workspace/src/main.rs”).

kind: ChangeKind

What kind of mutation this is.

diff_content: DiffContent

The actual change content (diff, new file, etc.).

preview_ref: Option<String>

Optional pointer to a rendered preview (e.g., a diff viewer URL).

risk_flags: Vec<String>

Risk flags identified by the system (e.g., “contains_secrets”, “large_change”).

commit_intent: CommitIntent

What the agent intends to do with this change once approved.

created_at: DateTime<Utc>

When this changeset was created.

content_hash: String

SHA-256 hash of the diff content for integrity verification.

Implementations

impl ChangeSet

pub fn new( target_uri: String, kind: ChangeKind, diff_content: DiffContent, ) -> Self

Create a new changeset with automatically computed content hash.

The content hash is computed from the serialized diff_content, ensuring integrity can be verified later.

pub fn with_commit_intent(self, intent: CommitIntent) -> Self

Set the commit intent and return self (builder pattern).

pub fn with_risk_flag(self, flag: impl Into<String>) -> Self

Add a risk flag and return self.

pub fn verify_hash(&self) -> bool

Verify the content hash matches the actual diff content.

Trait Implementations

impl Clone for ChangeSet

fn clone(&self) -> ChangeSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChangeSet

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ChangeSet

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ChangeSet

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

where __S: Serializer,

Serialize this value into the given Serde serializer.