The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
feat(ecc2): persist file activity diff previews
Affaan Mustafac395b42d2c96
diff --git a/ecc2/src/session/mod.rs b/ecc2/src/session/mod.rsindex 188324ede..0482e057d 100644--- a/ecc2/src/session/mod.rs+++ b/ecc2/src/session/mod.rs@@ -134,6 +134,7 @@ pub struct FileActivityEntry {pub action: FileActivityAction,pub path: String,pub summary: String,+ pub diff_preview: Option<String>,pub timestamp: DateTime<Utc>,}diff --git a/ecc2/src/session/store.rs b/ecc2/src/session/store.rsindex a237aa879..b800ca65b 100644--- a/ecc2/src/session/store.rs+++ b/ecc2/src/session/store.rs@@ -759,6 +759,8 @@ impl StateStore {struct ToolActivityFileEvent {path: String,action: String,+ #[serde(default)]+ diff_preview: Option<String>,}let file = File::open(metrics_path)@@ -800,6 +802,7 @@ impl StateStore {.map(|path| PersistedFileEvent {path,action: infer_file_activity_action(&row.tool_name),+ diff_preview: None,}).collect()} else {@@ -814,6 +817,7 @@ impl StateStore {path,action: parse_file_activity_action(&event.action).unwrap_or_else(|| infer_file_activity_action(&row.tool_name)),+ diff_preview: normalize_optional_string(event.diff_preview),})}).collect()@@ -1594,6 +1598,7 @@ impl StateStore {Some(PersistedFileEvent {path,action: infer_file_activity_action(&tool_name),+ diff_preview: None,})}).collect()@@ -1605,6 +1610,7 @@ impl StateStore {action: event.action,path: event.path,summary: summary.clone(),+ diff_preview: event.diff_preview,timestamp: occurred_at,});if events.len() >= limit {@@ -1621,6 +1627,8 @@ impl StateStore {struct PersistedFileEvent {path: String,action: FileActivityAction,+ #[serde(default, skip_serializing_if = "Option::is_none")]+ diff_preview: Option<String>,}fn parse_persisted_file_events(value: &str) -> Option<Vec<PersistedFileEvent>> {@@ -1635,6 +1643,7 @@ fn parse_persisted_file_events(value: &str) -> Option<Vec<PersistedFileEvent>> {Some(PersistedFileEvent {path,action: event.action,+ diff_preview: normalize_optional_string(event.diff_preview),})}).collect();@@ -1656,6 +1665,17 @@ fn parse_file_activity_action(value: &str) -> Option<FileActivityAction> {}}+fn normalize_optional_string(value: Option<String>) -> Option<String> {+ value.and_then(|value| {+ let trimmed = value.trim();+ if trimmed.is_empty() {+ None+ } else {+ Some(trimmed.to_string())+ }+ })+}+fn infer_file_activity_action(tool_name: &str) -> FileActivityAction {let tool_name = tool_name.trim().to_ascii_lowercase();if tool_name.contains("read") {@@ -1938,6 +1958,50 @@ mod tests {Ok(())}+ #[test]+ fn list_file_activity_preserves_diff_previews() -> Result<()> {+ let tempdir = TestDir::new("store-file-activity-diffs")?;+ let db = StateStore::open(&tempdir.path().join("state.db"))?;+ let now = Utc::now();++ db.insert_session(&Session {+ id: "session-1".to_string(),+ task: "sync tools".to_string(),+ agent_type: "claude".to_string(),+ working_dir: PathBuf::from("/tmp"),+ state: SessionState::Running,+ pid: None,+ worktree: None,+ created_at: now,+ updated_at: now,+ last_heartbeat_at: now,+ metrics: SessionMetrics::default(),+ })?;++ let metrics_dir = tempdir.path().join("metrics");+ fs::create_dir_all(&metrics_dir)?;+ let metrics_path = metrics_dir.join("tool-usage.jsonl");+ fs::write(+ &metrics_path,+ concat!(+ "{\"id\":\"evt-1\",\"session_id\":\"session-1\",\"tool_name\":\"Edit\",\"input_summary\":\"Edit src/config.ts\",\"output_summary\":\"updated config\",\"file_paths\":[\"src/config.ts\"],\"file_events\":[{\"path\":\"src/config.ts\",\"action\":\"modify\",\"diff_preview\":\"API_URL=http://localhost:3000 -> API_URL=https://api.example.com\"}],\"timestamp\":\"2026-04-09T00:00:00Z\"}\n"+ ),+ )?;++ db.sync_tool_activity_metrics(&metrics_path)?;++ let activity = db.list_file_activity("session-1", 10)?;+ assert_eq!(activity.len(), 1);+ assert_eq!(activity[0].action, FileActivityAction::Modify);+ assert_eq!(activity[0].path, "src/config.ts");+ assert_eq!(+ activity[0].diff_preview.as_deref(),+ Some("API_URL=http://localhost:3000 -> API_URL=https://api.example.com")+ );++ Ok(())+ }+#[test]fn refresh_session_durations_updates_running_and_terminal_sessions() -> Result<()> {let tempdir = TestDir::new("store-duration-metrics")?;diff --git a/ecc2/src/tui/dashboard.rs b/ecc2/src/tui/dashboard.rsindex a708a8a0f..809ae9266 100644--- a/ecc2/src/tui/dashboard.rs+++ b/ecc2/src/tui/dashboard.rs@@ -5398,11 +5398,18 @@ fn session_state_color(state: &SessionState) -> Color {}fn file_activity_summary(entry: &FileActivityEntry) -> String {- format!(+ let mut summary = format!("{} {}",file_activity_verb(entry.action.clone()),truncate_for_dashboard(&entry.path, 72)- )+ );++ if let Some(diff_preview) = entry.diff_preview.as_ref() {+ summary.push_str(" | ");+ summary.push_str(&truncate_for_dashboard(diff_preview, 56));+ }++ summary}fn file_activity_verb(action: crate::session::FileActivityAction) -> &'static str {@@ -6085,7 +6092,7 @@ mod tests {&metrics_path,concat!("{\"id\":\"evt-1\",\"session_id\":\"focus-12345678\",\"tool_name\":\"Read\",\"input_summary\":\"Read src/lib.rs\",\"output_summary\":\"ok\",\"file_paths\":[\"src/lib.rs\"],\"timestamp\":\"2026-04-09T00:00:00Z\"}\n",- "{\"id\":\"evt-2\",\"session_id\":\"focus-12345678\",\"tool_name\":\"Write\",\"input_summary\":\"Write README.md\",\"output_summary\":\"updated readme\",\"file_paths\":[\"README.md\"],\"timestamp\":\"2026-04-09T00:01:00Z\"}\n"+ "{\"id\":\"evt-2\",\"session_id\":\"focus-12345678\",\"tool_name\":\"Write\",\"input_summary\":\"Write README.md\",\"output_summary\":\"updated readme\",\"file_paths\":[\"README.md\"],\"file_events\":[{\"path\":\"README.md\",\"action\":\"create\",\"diff_preview\":\"+ # ECC 2.0\"}],\"timestamp\":\"2026-04-09T00:01:00Z\"}\n"),)?;dashboard.db.sync_tool_activity_metrics(&metrics_path)?;@@ -6095,11 +6102,13 @@ mod tests {let rendered = dashboard.rendered_output_text(180, 30);assert!(rendered.contains("read src/lib.rs"));assert!(rendered.contains("create README.md"));+ assert!(rendered.contains("+ # ECC 2.0"));assert!(!rendered.contains("files touched 2"));let metrics_text = dashboard.selected_session_metrics_text();assert!(metrics_text.contains("Recent file activity"));assert!(metrics_text.contains("create README.md"));+ assert!(metrics_text.contains("+ # ECC 2.0"));assert!(metrics_text.contains("read src/lib.rs"));let _ = fs::remove_dir_all(root);diff --git a/scripts/hooks/session-activity-tracker.js b/scripts/hooks/session-activity-tracker.jsindex 8627de00f..917217c02 100644--- a/scripts/hooks/session-activity-tracker.js+++ b/scripts/hooks/session-activity-tracker.js@@ -62,7 +62,7 @@ function pushPathCandidate(paths, value) {}}-function pushFileEvent(events, value, action) {+function pushFileEvent(events, value, action, diffPreview) {const candidate = String(value || '').trim();if (!candidate) {return;@@ -70,9 +70,50 @@ function pushFileEvent(events, value, action) {if (/^(https?:\/\/|app:\/\/|plugin:\/\/|mcp:\/\/)/i.test(candidate)) {return;}- if (!events.some(event => event.path === candidate && event.action === action)) {- events.push({ path: candidate, action });+ const normalizedDiffPreview = typeof diffPreview === 'string' && diffPreview.trim()+ ? diffPreview.trim()+ : undefined;+ if (!events.some(event =>+ event.path === candidate+ && event.action === action+ && (event.diff_preview || undefined) === normalizedDiffPreview+ )) {+ const event = { path: candidate, action };+ if (normalizedDiffPreview) {+ event.diff_preview = normalizedDiffPreview;+ }+ events.push(event);+ }+}++function sanitizeDiffText(value, maxLength = 96) {+ if (typeof value !== 'string' || !value.trim()) {+ return '';+ }+ return truncateSummary(value, maxLength);+}++function buildReplacementPreview(oldValue, newValue) {+ const before = sanitizeDiffText(oldValue);+ const after = sanitizeDiffText(newValue);+ if (!before && !after) {+ return undefined;+ }+ if (!before) {+ return `-> ${after}`;}+ if (!after) {+ return `${before} ->`;+ }+ return `${before} -> ${after}`;+}++function buildCreationPreview(content) {+ const normalized = sanitizeDiffText(content);+ if (!normalized) {+ return undefined;+ }+ return `+ ${normalized}`;}function inferDefaultFileAction(toolName) {@@ -129,6 +170,11 @@ function collectFilePaths(value, paths) {for (const [key, nested] of Object.entries(value)) {if (FILE_PATH_KEYS.has(key)) {collectFilePaths(nested, paths);+ continue;+ }++ if (nested && (Array.isArray(nested) || typeof nested === 'object')) {+ collectFilePaths(nested, paths);}}}@@ -142,20 +188,39 @@ function extractFilePaths(toolInput) {return paths;}-function collectFileEvents(toolName, value, events, key = null) {+function fileEventDiffPreview(toolName, value, action) {+ if (!value || typeof value !== 'object' || Array.isArray(value)) {+ return undefined;+ }++ if (typeof value.old_string === 'string' || typeof value.new_string === 'string') {+ return buildReplacementPreview(value.old_string, value.new_string);+ }++ if (action === 'create') {+ return buildCreationPreview(value.content || value.file_text || value.text);+ }++ return undefined;+}++function collectFileEvents(toolName, value, events, key = null, parentValue = null) {if (!value) {return;}if (Array.isArray(value)) {for (const entry of value) {- collectFileEvents(toolName, entry, events, key);+ collectFileEvents(toolName, entry, events, key, parentValue);}return;}if (typeof value === 'string') {- pushFileEvent(events, value, actionForFileKey(toolName, key));+ if (key && FILE_PATH_KEYS.has(key)) {+ const action = actionForFileKey(toolName, key);+ pushFileEvent(events, value, action, fileEventDiffPreview(toolName, parentValue, action));+ }return;}@@ -165,7 +230,12 @@ function collectFileEvents(toolName, value, events, key = null) {for (const [nestedKey, nested] of Object.entries(value)) {if (FILE_PATH_KEYS.has(nestedKey)) {- collectFileEvents(toolName, nested, events, nestedKey);+ collectFileEvents(toolName, nested, events, nestedKey, value);+ continue;+ }++ if (nested && (Array.isArray(nested) || typeof nested === 'object')) {+ collectFileEvents(toolName, nested, events, null, nested);}}}@@ -234,8 +304,10 @@ function buildActivityRow(input, env = process.env) {}const toolInput = input?.tool_input || {};- const filePaths = extractFilePaths(toolInput);const fileEvents = extractFileEvents(toolName, toolInput);+ const filePaths = fileEvents.length > 0+ ? [...new Set(fileEvents.map(event => event.path))]+ : extractFilePaths(toolInput);return {id: `tool-${Date.now()}-${crypto.randomBytes(6).toString('hex')}`,diff --git a/tests/hooks/session-activity-tracker.test.js b/tests/hooks/session-activity-tracker.test.jsindex c2f015071..d1af7b3d0 100644--- a/tests/hooks/session-activity-tracker.test.js+++ b/tests/hooks/session-activity-tracker.test.js@@ -130,6 +130,83 @@ function runTests() {fs.rmSync(tmpHome, { recursive: true, force: true });}) ? passed++ : failed++);+ (test('captures replacement diff previews for edit tool input', () => {+ const tmpHome = makeTempDir();+ const input = {+ tool_name: 'Edit',+ tool_input: {+ file_path: 'src/config.ts',+ old_string: 'API_URL=http://localhost:3000',+ new_string: 'API_URL=https://api.example.com',+ },+ tool_output: { output: 'updated config' },+ };+ const result = runScript(input, {+ ...withTempHome(tmpHome),+ CLAUDE_HOOK_EVENT_NAME: 'PostToolUse',+ ECC_SESSION_ID: 'ecc-session-edit',+ });+ assert.strictEqual(result.code, 0);++ const metricsFile = path.join(tmpHome, '.claude', 'metrics', 'tool-usage.jsonl');+ const row = JSON.parse(fs.readFileSync(metricsFile, 'utf8').trim());+ assert.deepStrictEqual(row.file_events, [+ {+ path: 'src/config.ts',+ action: 'modify',+ diff_preview: 'API_URL=http://localhost:3000 -> API_URL=https://api.example.com',+ },+ ]);++ fs.rmSync(tmpHome, { recursive: true, force: true });+ }) ? passed++ : failed++);++ (test('captures MultiEdit nested edits with typed diff previews', () => {+ const tmpHome = makeTempDir();+ const input = {+ tool_name: 'MultiEdit',+ tool_input: {+ edits: [+ {+ file_path: 'src/a.ts',+ old_string: 'const a = 1;',+ new_string: 'const a = 2;',+ },+ {+ file_path: 'src/b.ts',+ old_string: 'old name',+ new_string: 'new name',+ },+ ],+ },+ tool_output: { output: 'updated two files' },+ };+ const result = runScript(input, {+ ...withTempHome(tmpHome),+ CLAUDE_HOOK_EVENT_NAME: 'PostToolUse',+ ECC_SESSION_ID: 'ecc-session-multiedit',+ });+ assert.strictEqual(result.code, 0);++ const metricsFile = path.join(tmpHome, '.claude', 'metrics', 'tool-usage.jsonl');+ const row = JSON.parse(fs.readFileSync(metricsFile, 'utf8').trim());+ assert.deepStrictEqual(row.file_paths, ['src/a.ts', 'src/b.ts']);+ assert.deepStrictEqual(row.file_events, [+ {+ path: 'src/a.ts',+ action: 'modify',+ diff_preview: 'const a = 1; -> const a = 2;',+ },+ {+ path: 'src/b.ts',+ action: 'modify',+ diff_preview: 'old name -> new name',+ },+ ]);++ fs.rmSync(tmpHome, { recursive: true, force: true });+ }) ? passed++ : failed++);+(test('prefers ECC_SESSION_ID over CLAUDE_SESSION_ID and redacts bash summaries', () => {const tmpHome = makeTempDir();const input = {