frame 0.1.5

A markdown task tracker with a terminal UI for humans and a CLI for 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

use ratatui::Frame;
use ratatui::layout::Rect;
use ratatui::style::{Color, Modifier, Style};
use ratatui::text::{Line, Span};
use ratatui::widgets::{Block, Borders, Clear, Paragraph};

use crate::tui::app::App;
use crate::tui::wrap;

/// Render the recovery log overlay (full-screen popup)
pub fn render_recovery_overlay(frame: &mut Frame, app: &mut App, area: Rect) {
    let bg = app.theme.background;
    let text_color = app.theme.text;
    let bright = app.theme.text_bright;
    let dim = app.theme.dim;
    let highlight = app.theme.highlight;

    // Size: centered, taking most of the screen
    let margin_x = 4u16.min(area.width / 8);
    let margin_y = 2u16.min(area.height / 8);
    let popup_area = Rect::new(
        area.x + margin_x,
        area.y + margin_y,
        area.width.saturating_sub(margin_x * 2),
        area.height.saturating_sub(margin_y * 2),
    );

    frame.render_widget(Clear, popup_area);

    let block = Block::default()
        .title(Span::styled(
            " Recovery Log ",
            Style::default()
                .fg(bright)
                .bg(bg)
                .add_modifier(Modifier::BOLD),
        ))
        .borders(Borders::ALL)
        .border_style(Style::default().fg(dim).bg(bg))
        .style(Style::default().bg(bg));

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

    if app.recovery_log_lines.is_empty() {
        let empty = Paragraph::new(Line::from(Span::styled(
            "No recovery log entries.",
            Style::default().fg(dim).bg(bg),
        )))
        .style(Style::default().bg(bg));
        frame.render_widget(empty, inner);
        return;
    }

    // Word-wrap logical lines to inner width, producing visual lines with styles
    let wrap_width = inner.width as usize;
    let mut visual_lines: Vec<(String, Style)> = Vec::new();
    let mut line_offsets: Vec<usize> = Vec::with_capacity(app.recovery_log_lines.len());

    for logical_line in &app.recovery_log_lines {
        line_offsets.push(visual_lines.len());

        let style = if logical_line.starts_with("## ") {
            Style::default()
                .fg(highlight)
                .bg(bg)
                .add_modifier(Modifier::BOLD)
        } else if logical_line.starts_with("```") || logical_line == "---" {
            Style::default().fg(dim).bg(bg)
        } else {
            Style::default().fg(text_color).bg(bg)
        };

        let wrapped = wrap::wrap_line(logical_line, wrap_width, 0);
        for vl in &wrapped {
            let text = &logical_line[vl.byte_start..vl.byte_end];
            visual_lines.push((text.to_string(), style));
        }
    }

    let total_visual = visual_lines.len();
    app.recovery_log_wrapped_count = total_visual;
    app.recovery_log_line_offsets = line_offsets;

    // Clamp scroll
    let visible_height = inner.height as usize;
    let scroll = app
        .recovery_log_scroll
        .min(total_visual.saturating_sub(visible_height));
    app.recovery_log_scroll = scroll;

    let lines: Vec<Line> = visual_lines
        .iter()
        .skip(scroll)
        .take(visible_height)
        .map(|(text, style)| Line::from(Span::styled(text.clone(), *style)))
        .collect();

    let paragraph = Paragraph::new(lines).style(Style::default().bg(bg));
    frame.render_widget(paragraph, inner);

    // Scroll indicator
    if total_visual > visible_height {
        let indicator = format!(
            " {}/{} ",
            scroll + 1,
            total_visual.saturating_sub(visible_height) + 1
        );
        let indicator_style = Style::default()
            .fg(Color::Black)
            .bg(dim)
            .add_modifier(Modifier::BOLD);
        let indicator_width = indicator.len() as u16;
        let indicator_x = popup_area.x + popup_area.width.saturating_sub(indicator_width + 1);
        let indicator_y = popup_area.y + popup_area.height - 1;
        if indicator_x < popup_area.x + popup_area.width && indicator_y < area.y + area.height {
            let indicator_area = Rect::new(indicator_x, indicator_y, indicator_width, 1);
            let indicator_widget =
                Paragraph::new(Line::from(Span::styled(indicator, indicator_style)));
            frame.render_widget(indicator_widget, indicator_area);
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::tui::render::test_helpers::*;
    use insta::assert_snapshot;

    #[test]
    fn recovery_log_visible() {
        let mut app = app_with_track(SIMPLE_TRACK_MD);
        app.show_recovery_log = true;
        app.recovery_log_lines = vec![
            "Recovery entry 1: restored track.md".into(),
            "Recovery entry 2: restored inbox.md".into(),
        ];
        let output = render_to_string(TERM_W, TERM_H, |frame, area| {
            render_recovery_overlay(frame, &mut app, area);
        });
        assert_snapshot!(output);
    }
}