frame 0.1.6

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

use ratatui::text::Span;

use crate::model::task::{Metadata, Task, TaskState};
use crate::util::unicode;

/// State symbols for each task state (markdown checkbox style)
pub(super) fn state_symbol(state: TaskState) -> &'static str {
    match state {
        TaskState::Todo => "[ ]",
        TaskState::Active => "[>]",
        TaskState::Blocked => "[-]",
        TaskState::Done => "[x]",
        TaskState::Parked => "[~]",
    }
}

/// Get abbreviated ID (e.g., "EFF-014.2" -> ".2")
pub(super) fn abbreviated_id(id: &str) -> &str {
    if let Some(dash_pos) = id.find('-') {
        let after_prefix = &id[dash_pos + 1..];
        if let Some(dot_pos) = after_prefix.find('.') {
            return &after_prefix[dot_pos..];
        }
    }
    id
}

/// Collect metadata list items (deps or refs) from a task
pub(super) fn collect_metadata_list(
    task: &Task,
    f: impl Fn(&Metadata) -> Option<&Vec<String>>,
) -> Vec<String> {
    let mut result = Vec::new();
    for meta in &task.metadata {
        if let Some(items) = f(meta) {
            result.extend(items.clone());
        }
    }
    result
}

/// Compute total display width of a slice of spans
pub(super) fn spans_width(spans: &[Span]) -> usize {
    spans
        .iter()
        .map(|s| unicode::display_width(&s.content))
        .sum()
}

#[cfg(test)]
mod tests {
    use super::abbreviated_id;

    #[test]
    fn abbreviated_id_keeps_token_in_subtask_tail() {
        // The tail is a string slice, so the subtask token survives: the
        // tail of `EFF-a14.b2` is `.b2` (not `.2`).
        assert_eq!(abbreviated_id("EFF-a14.b2"), ".b2");
        assert_eq!(abbreviated_id("EFF-a14.b2.c3"), ".b2.c3");
        // Null-namespace subtasks abbreviate as before.
        assert_eq!(abbreviated_id("EFF-014.2"), ".2");
    }

    #[test]
    fn abbreviated_id_renders_top_level_tokened_id_in_full() {
        // A top-level tokened id has no `.` after the prefix, so it renders
        // verbatim, token included.
        assert_eq!(abbreviated_id("EFF-a14"), "EFF-a14");
        assert_eq!(abbreviated_id("EFF-14"), "EFF-14");
    }
}