agentdiff 0.1.0

Audit and trace autonomous AI code contributions in git repositories
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
use std::collections::HashMap;

/// One edit event captured by a capture script.
/// Matches the JSON schema written by capture.py / agentblame-capture.py.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Entry {
    pub timestamp: DateTime<Utc>,
    pub agent: String,
    #[serde(default)]
    pub mode: Option<String>, // "agent" | "tab" — Cursor-specific
    pub model: String,
    pub session_id: String,
    pub tool: String,
    pub file: String, // repo-relative path
    pub abs_file: String,
    #[serde(default)]
    pub prompt: Option<String>,
    #[serde(default = "default_acceptance")]
    pub acceptance: String,
    #[serde(default)]
    pub lines: Vec<u32>,

    // Edit-specific
    #[serde(skip_serializing_if = "Option::is_none")]
    pub old: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub new: Option<String>,

    // Write-specific
    #[serde(skip_serializing_if = "Option::is_none")]
    pub content_preview: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub total_lines: Option<u32>,

    // MultiEdit-specific
    #[serde(skip_serializing_if = "Option::is_none")]
    pub edit_count: Option<u32>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub edits: Option<Vec<EditPair>>,

    // Injected at load time — not in the raw JSON
    #[serde(skip)]
    pub committed: bool,
    #[serde(skip)]
    pub commit_hash: String,
    #[serde(skip)]
    pub batch_author: String,
}

fn default_acceptance() -> String {
    "verbatim".to_string()
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct EditPair {
    pub old: String,
    pub new: String,
}

/// A committed batch — the JSON written by the post-commit hook.
/// schema_version = "1.0"
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CommittedBatch {
    pub schema_version: String,
    pub commit: String,
    pub author: String,
    pub committed_at: DateTime<Utc>,
    pub entries: Vec<Entry>,
}

/// Compact commit-scoped note payload written to refs/notes/agentdiff
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct NotesRecord {
    pub version: String,
    pub commit: String,
    pub generated_at: DateTime<Utc>,
    #[serde(default)]
    pub contributors: Vec<NotesContributor>,
    #[serde(default)]
    pub files: Vec<NotesFileAttribution>,
    #[serde(default)]
    pub trace_ids: Vec<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct NotesContributor {
    pub id: String,
    pub agent: String,
    pub model: String,
    pub session_ref: String,
    #[serde(default)]
    pub intent: String,
    #[serde(default)]
    pub prompt_excerpt: String,
    #[serde(default)]
    pub prompt_hash: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct NotesFileAttribution {
    pub path: String,
    pub tool: String,
    pub contributor_id: String,
    /// [start, end] (inclusive) line ranges at this commit revision.
    #[serde(default)]
    pub ranges: Vec<(u32, u32)>,
}

/// Canonical append-only ledger entry (one line per commit) stored at
/// <repo>/.agentdiff/ledger.jsonl
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct LedgerRecord {
    pub sha: String,
    pub ts: DateTime<Utc>,
    pub agent: String,
    pub model: String,
    pub session_id: String,
    #[serde(default)]
    pub author: Option<String>,
    #[serde(default)]
    pub files_touched: Vec<String>,
    /// Per-file line ranges [start, end] (inclusive)
    #[serde(default)]
    pub lines: HashMap<String, Vec<(u32, u32)>>,
    #[serde(default)]
    pub prompt_excerpt: String,
    #[serde(default)]
    pub prompt_hash: String,
    #[serde(default)]
    pub files_read: Vec<String>,
    #[serde(default)]
    pub intent: Option<String>,
    #[serde(default)]
    pub trust: Option<u8>,
    #[serde(default)]
    pub flags: Vec<String>,
    #[serde(default)]
    pub tool: Option<String>,
    #[serde(default)]
    pub mode: Option<String>,
}