gwm-cli 1.6.1

git worktree manager — TUI + CLI, native libgit2, per-repo bootstrap
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
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168

//! Clean overlay state (issue #325).
//!
//! Holds the reclaim scan snapshot for the selected worktree, the
//! `[clean.profiles.*]` picker, and a dedicated safety countdown
//! ([`ConfirmModal`]) for the destructive delete.
//!
//! Pure state: the `App` orchestrator owns the I/O — the
//! `clean::scan_worktree_safe` walk that fills the snapshot (already gated to
//! the git-ignored, untracked artifacts the CLI would delete) and the
//! `clean::delete_reclaim` that consumes it. The countdown reuses the exact
//! same timer the delete-confirm modal uses (`confirm.rs`), but as a separate
//! instance driven by `[tui] confirm_countdown_secs` directly — clean has no
//! `delete_branch_on_remove` gate.

use super::confirm::ConfirmModal;
use crate::clean::WorktreeReclaim;
use std::path::{Path, PathBuf};

/// The picker label for the no-`--profile` choice — the directory set
/// `gwm clean` resolves with no profile (`[clean.profiles.default]` when
/// defined, else the built-in `target` / `node_modules` / `dist` / `build`).
pub const DEFAULT_CHOICE_LABEL: &str = "(default)";

/// Pure state for the clean overlay. `Default` is a closed overlay (no
/// choices, no snapshot, disarmed countdown).
#[derive(Debug, Default)]
pub struct CleanOverlay {
  /// Picker choices: `None` (the no-`--profile` path — `gwm clean` resolves
  /// the `default` profile when defined, else the built-in set) followed by
  /// each configured `[clean.profiles.*]` name. The leading `None` is always
  /// present once [`Self::open`] has run, so the overlay's default matches
  /// the CLI even when a repo defines only non-`default` profiles — and the
  /// built-in set stays reachable.
  choices: Vec<Option<String>>,
  /// Highlighted choice row.
  selected: usize,
  /// The worktree (display name + path) the overlay was opened for, captured
  /// at open so every re-scan and the final delete pin to *that* worktree —
  /// not the live selection, which an auto-refresh can drift while the
  /// overlay sits open / armed (Codex #333 review).
  target: Option<(String, PathBuf)>,
  /// The most recent gated scan snapshot for the selected worktree, filled
  /// by `App::enter_clean_overlay` and re-filled on a choice change. `None`
  /// before the first scan.
  reclaim: Option<WorktreeReclaim>,
  /// Directory names found but preserved by the safety gate (not
  /// git-ignored, or holding tracked files) — surfaced so the user
  /// understands why a visible `target/` was not counted.
  skipped: Vec<String>,
  /// Safety countdown for the delete. Armed by the confirm key; the run
  /// loop fires `clean::delete_reclaim` when it elapses.
  pub confirm: ConfirmModal,
}

impl CleanOverlay {
  pub fn new() -> Self {
    Self::default()
  }

  /// Populate the picker from the configured profile names, reset the
  /// highlight to the `(default)` choice, and clear any stale snapshot /
  /// countdown. The orchestrator follows this with [`Self::set_scan`] once
  /// the first scan completes.
  ///
  /// Opens on the no-`--profile` choice so the overlay's first preview always
  /// matches what `gwm clean` would resolve — the built-in set, or
  /// `[clean.profiles.default]` when defined — regardless of which optional
  /// profiles the repo adds. `name` / `path` are the worktree the overlay
  /// targets, captured here so re-scans and the delete pin to it.
  pub fn open(&mut self, profiles: Vec<String>, name: String, path: PathBuf) {
    self.choices = std::iter::once(None).chain(profiles.into_iter().map(Some)).collect();
    self.selected = 0;
    self.target = Some((name, path));
    self.reclaim = None;
    self.skipped.clear();
    self.confirm.reset();
  }

  /// The worktree (display name, path) the overlay was opened for. Every scan
  /// and the delete resolve against this captured target, not the live
  /// selection.
  pub fn target(&self) -> Option<(&str, &Path)> {
    self.target.as_ref().map(|(n, p)| (n.as_str(), p.as_path()))
  }

  /// The picker labels, in display order. The no-`--profile` entry renders as
  /// [`DEFAULT_CHOICE_LABEL`]; named profiles render as themselves.
  pub fn choice_labels(&self) -> Vec<&str> {
    self
      .choices
      .iter()
      .map(|c| c.as_deref().unwrap_or(DEFAULT_CHOICE_LABEL))
      .collect()
  }

  /// `true` when the repo configures at least one named profile, so the
  /// picker is worth rendering (otherwise there is only the implicit
  /// `(default)` choice).
  pub fn has_profiles(&self) -> bool {
    self.choices.len() > 1
  }

  /// The highlighted choice row.
  pub fn selected_index(&self) -> usize {
    self.selected
  }

  /// The highlighted profile name to hand to `resolve_clean_dirs`: `None` for
  /// the `(default)` choice (no `--profile`), `Some(name)` for a configured
  /// profile.
  pub fn selected_profile(&self) -> Option<&str> {
    self.choices.get(self.selected).and_then(|c| c.as_deref())
  }

  /// Move the highlight down one row, wrapping. Returns `true` when the
  /// highlight actually moved (so the orchestrator re-scans and the re-scan
  /// disarms the countdown). A no-op — fewer than two choices — returns
  /// `false` and leaves an armed countdown untouched, so a stray `j` with
  /// only the `(default)` choice can't silently cancel a pending reclaim
  /// (Codex #333 review).
  pub fn select_next(&mut self) -> bool {
    if self.choices.len() < 2 {
      return false;
    }
    self.selected = (self.selected + 1) % self.choices.len();
    true
  }

  /// Move the highlight up one row, wrapping. Returns `true` when the
  /// highlight actually moved; a no-op (fewer than two choices) returns
  /// `false` and leaves an armed countdown untouched.
  pub fn select_prev(&mut self) -> bool {
    if self.choices.len() < 2 {
      return false;
    }
    self.selected = (self.selected + self.choices.len() - 1) % self.choices.len();
    true
  }

  /// Store a fresh scan snapshot + the gate-preserved names, disarming any
  /// running countdown (the figures it was about to act on just changed).
  pub fn set_scan(&mut self, reclaim: WorktreeReclaim, skipped: Vec<String>) {
    self.reclaim = Some(reclaim);
    self.skipped = skipped;
    self.confirm.reset();
  }

  /// The current gated scan snapshot, if any.
  pub fn reclaim(&self) -> Option<&WorktreeReclaim> {
    self.reclaim.as_ref()
  }

  /// Directory names the safety gate preserved in the current scan.
  pub fn skipped(&self) -> &[String] {
    &self.skipped
  }

  /// Total reclaimable bytes in the current snapshot (`0` before a scan or
  /// when nothing is safe to delete).
  pub fn total_bytes(&self) -> u64 {
    self.reclaim.as_ref().map(|r| r.total_bytes).unwrap_or(0)
  }

  /// `true` when the current scan has nothing safe to reclaim.
  pub fn is_empty_scan(&self) -> bool {
    self.total_bytes() == 0
  }
}