lazytask 0.5.0

A task manager built for AI coding agents — plain markdown files, strict CLI, keyboard-driven TUI
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

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(crate) struct ConfigKeySchema {
    pub name: &'static str,
    pub default: usize,
    pub description: &'static str,
    pub min: usize,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(crate) struct ConfigSectionSchema {
    pub name: &'static str,
    pub keys: &'static [ConfigKeySchema],
}

const LIMITS_KEYS: [ConfigKeySchema; 2] = [
    ConfigKeySchema {
        name: "todo",
        default: 20,
        description: "max todo tasks",
        min: 1,
    },
    ConfigKeySchema {
        name: "in_progress",
        default: 3,
        description: "max in-progress tasks",
        min: 1,
    },
];

const HINTS_KEYS: [ConfigKeySchema; 1] = [ConfigKeySchema {
    name: "learn_threshold",
    default: 35,
    description: "show `lt learn` hint after this many LEARNINGS.md lines",
    min: 1,
}];

const RETENTION_KEYS: [ConfigKeySchema; 1] = [ConfigKeySchema {
    name: "done_discard_ttl_days",
    default: 3,
    description: "auto-delete done/discard tasks older than this many days",
    min: 1,
}];

pub(crate) const USER_CONFIG_SCHEMA: [ConfigSectionSchema; 3] = [
    ConfigSectionSchema {
        name: "limits",
        keys: &LIMITS_KEYS,
    },
    ConfigSectionSchema {
        name: "hints",
        keys: &HINTS_KEYS,
    },
    ConfigSectionSchema {
        name: "retention",
        keys: &RETENTION_KEYS,
    },
];

/// Looks up schema metadata for a config key.
pub(crate) fn key_schema(section: &str, key: &str) -> Option<&'static ConfigKeySchema> {
    USER_CONFIG_SCHEMA
        .iter()
        .find(|candidate| candidate.name == section)
        .and_then(|candidate| candidate.keys.iter().find(|entry| entry.name == key))
}

/// Returns the default value for a known schema key.
pub(crate) fn default_usize(section: &str, key: &str) -> usize {
    key_schema(section, key)
        .map(|entry| entry.default)
        .unwrap_or_else(|| panic!("missing schema entry for {section}.{key}"))
}

/// Returns the minimum allowed value for a known schema key.
pub(crate) fn min_usize(section: &str, key: &str) -> usize {
    key_schema(section, key)
        .map(|entry| entry.min)
        .unwrap_or_else(|| panic!("missing schema entry for {section}.{key}"))
}

/// Renders the full default `lazytask.toml` body from schema constants.
pub(crate) fn render_default_config_body() -> String {
    let mut body = String::new();

    for (section_index, section) in USER_CONFIG_SCHEMA.iter().enumerate() {
        if section_index > 0 {
            body.push('\n');
        }
        body.push_str(&format!("[{}]\n", section.name));
        for key in section.keys {
            body.push_str(&format!(
                "{} = {} # {}\n",
                key.name, key.default, key.description
            ));
        }
        // Append boolean keys that live outside the usize-only schema.
        if section.name == "retention" {
            body.push_str(RETENTION_CLEANUP_ASSETS_LINE);
        }
    }

    body
}

/// Default line for the `cleanup_task_assets` boolean key in `[retention]`.
const RETENTION_CLEANUP_ASSETS_LINE: &str =
    "cleanup_task_assets = true # delete referenced images when a task is deleted\n";