sandspy 0.1.1

Real-time security monitor for AI coding agents
Documentation 
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
144
145
146

// sandspy::ui::diff_viewer — Diffs tab (Tab::Diffs)
//
// Shows a colored diff of written files using the `similar` crate.
// Left: file list. Right: diff content.

use crate::events::{Event, EventKind};
use crate::ui::{app::App, theme};
use ratatui::{
    layout::{Constraint, Layout, Rect},
    style::{Color, Modifier, Style},
    text::{Line, Span},
    widgets::{Block, BorderType, Borders, List, ListItem, Paragraph, Wrap},
    Frame,
};

pub fn render(frame: &mut Frame, area: Rect, app: &App) {
    // Split horizontally: file list on left, diff on right
    let cols = Layout::horizontal([Constraint::Length(30), Constraint::Fill(1)]).split(area);

    render_file_list(frame, cols[0], app);
    render_diff_content(frame, cols[1], app);
}

fn render_file_list(frame: &mut Frame, area: Rect, app: &App) {
    let block = Block::default()
        .title(Span::styled(
            " FILES ",
            app.style(
                Style::default()
                    .fg(Color::Yellow)
                    .add_modifier(Modifier::BOLD),
            ),
        ))
        .borders(Borders::ALL)
        .border_type(BorderType::Plain)
        .border_style(app.style(theme::border()));

    let inner = block.inner(area);
    frame.render_widget(block, area);

    let write_events: Vec<&Event> = app
        .events
        .iter()
        .filter(|e| matches!(e.kind, EventKind::FileWrite { .. }))
        .collect();

    let items: Vec<ListItem> = write_events
        .iter()
        .map(|e| {
            if let EventKind::FileWrite { path, .. } = &e.kind {
                let name = path
                    .file_name()
                    .map(|f| f.to_string_lossy().to_string())
                    .unwrap_or_else(|| path.display().to_string());
                ListItem::new(Line::from(Span::styled(
                    format!("  {name}"),
                    app.style(Style::default().fg(Color::White)),
                )))
            } else {
                ListItem::new(Line::from(""))
            }
        })
        .collect();

    if items.is_empty() {
        let msg = Paragraph::new(Line::from(Span::styled(
            "  no writes yet",
            app.style(theme::dim()),
        )));
        frame.render_widget(msg, inner);
    } else {
        let list = List::new(items);
        frame.render_widget(list, inner);
    }
}

fn render_diff_content(frame: &mut Frame, area: Rect, app: &App) {
    let block = Block::default()
        .title(Span::styled(
            " DIFF ",
            app.style(
                Style::default()
                    .fg(Color::Cyan)
                    .add_modifier(Modifier::BOLD),
            ),
        ))
        .borders(Borders::ALL)
        .border_type(BorderType::Plain)
        .border_style(app.style(theme::border()));

    let inner = block.inner(area);
    frame.render_widget(block, area);

    // Find the most recent write event that has a diff_summary
    let last_write = app.events.iter().rev().find(|e| {
        matches!(
            &e.kind,
            EventKind::FileWrite {
                diff_summary: Some(_),
                ..
            }
        )
    });

    match last_write {
        None => {
            let msg = Paragraph::new(Line::from(Span::styled(
                "  no diffs captured yet",
                app.style(theme::dim()),
            )));
            frame.render_widget(msg, inner);
        }
        Some(event) => {
            if let EventKind::FileWrite {
                path,
                diff_summary: Some(summary),
            } = &event.kind
            {
                // We only have the summary string (e.g. "+15 -3"), not actual content.
                // Render it as a styled explanation instead.
                let lines = vec![
                    Line::from(Span::styled(
                        format!("  {}", path.display()),
                        app.style(
                            Style::default()
                                .fg(Color::White)
                                .add_modifier(Modifier::BOLD),
                        ),
                    )),
                    Line::from(""),
                    Line::from(Span::styled(
                        format!("  changes: {summary}"),
                        app.style(Style::default().fg(Color::Cyan)),
                    )),
                    Line::from(""),
                    Line::from(Span::styled(
                        "  (full diff available after session via sandspy report)",
                        app.style(theme::dim()),
                    )),
                ];
                let para = Paragraph::new(lines).wrap(Wrap { trim: false });
                frame.render_widget(para, inner);
            }
        }
    }
}