mise 2026.9.3

Dev tools, env vars, and tasks in one CLI
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

use eyre::Result;

use super::{display_arg, local_time};
use crate::system::history::store::Trigger;
use crate::ui::table::MiseTable;

/// List checkpoints, newest first
#[derive(Debug, usage_rs::Args)]
#[usage(visible_alias = "list", verbatim_doc_comment)]
pub(crate) struct HistoryLs {
    /// Output in JSON format
    #[usage(long, short = 'J')]
    json: bool,

    /// Show at most this many checkpoints (0 for all)
    #[usage(long, short = 'n', default_value_t = 20, default = "20")]
    limit: usize,

    /// Only checkpoints where this path (or something under it) changed
    #[usage(long, value_name = "PATH")]
    path: Option<String>,

    /// Only checkpoints with this trigger (edit, save, bootstrap, …)
    #[usage(long, value_name = "TRIGGER")]
    trigger: Option<String>,

    /// Only checkpoints with this label
    #[usage(long, value_name = "LABEL")]
    label: Option<String>,

    /// Only checkpoints recorded by operations that did not finish
    #[usage(long)]
    pending: bool,
}

impl HistoryLs {
    pub(crate) async fn run(self) -> Result<()> {
        let (store, _tracked, mut entries) = super::open().await?;
        if self.pending {
            // an operation still running, or one that crashed: its record
            // is in the index only once it is closed
            entries = crate::system::history::store::peek_pending_in(store.state_dir())?
                .into_iter()
                .map(|(_, pending)| crate::system::history::store::Entry {
                    id: pending.id,
                    commit: String::new(),
                    checkpoint: pending.checkpoint,
                })
                .collect();
        }
        entries.reverse();
        if let Some(label) = &self.label {
            entries.retain(|entry| entry.checkpoint.labels.contains(label));
        }
        if let Some(path) = &self.path {
            let path = display_arg(path);
            entries.retain(|entry| entry.checkpoint.changes.touches(&path));
        }
        if let Some(trigger) = &self.trigger {
            let Some(trigger) = Trigger::parse(trigger) else {
                eyre::bail!("unknown trigger {trigger:?}");
            };
            entries.retain(|entry| entry.checkpoint.trigger == trigger);
        }
        if self.limit > 0 {
            entries.truncate(self.limit);
        }
        if self.json {
            miseprintln!("{}", serde_json::to_string_pretty(&entries)?);
            return Ok(());
        }
        if entries.is_empty() {
            info!("no history checkpoints recorded");
            return Ok(());
        }
        let mut table = MiseTable::new(false, &["ID", "When", "Trigger", "Description", "Files"]);
        for entry in &entries {
            let checkpoint = &entry.checkpoint;
            let files = if checkpoint.tree.available {
                let changed = checkpoint.changes.len();
                if changed == 0 {
                    "-".to_string()
                } else {
                    changed.to_string()
                }
            } else {
                "unavailable".to_string()
            };
            let status = match checkpoint.status() {
                Some(status)
                    if status != crate::system::history::store::OperationStatus::Completed =>
                {
                    format!(" ({})", status.as_str())
                }
                _ => String::new(),
            };
            table.add_row(vec![
                entry.id.to_string(),
                local_time(&checkpoint.created_at),
                format!("{}{status}", checkpoint.kind_label()),
                checkpoint.description.clone(),
                files,
            ]);
        }
        table.print()
    }
}