gwm-cli 1.0.2

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

//! Exec profile picker state (issue #325).
//!
//! Pure state — no `App` / `Config` / PTY dependency beyond the sorted
//! profile-name list handed in at open time. The `App` orchestrator owns
//! resolving the highlighted profile to an argv (via
//! [`crate::exec::resolve_exec_command`]); the run loop owns spawning the
//! PTY overlay with that argv in the selected worktree's directory.
//!
//! The picker is deliberately tiny: a sorted list of `[exec.profiles.*]`
//! names, a wrapping highlight, and the worktree path it was opened for.
//! `Enter` accepts the highlight, `Esc` cancels — the `j`/`k`/arrow
//! navigation lives in [`crate::tui::modal_keymap`] under
//! `KeyContext::ExecPicker`.

use std::path::{Path, PathBuf};

/// Pure state for the exec profile picker. `Default` is an empty, closed
/// picker (no profiles, no target, highlight at 0).
#[derive(Debug, Default)]
pub struct ExecPicker {
  /// Exec profile names from `[exec.profiles.*]`, in the sorted order the
  /// orchestrator hands them over (a `BTreeMap` key walk).
  profiles: Vec<String>,
  /// Highlighted row index. Always a valid index into `profiles` while
  /// non-empty; the `next`/`prev` wrappers keep it in range.
  selected: usize,
  /// The worktree directory the picker was opened for. Captured at open so
  /// `Enter` runs the profile in *that* worktree even if an auto-refresh
  /// drifts the live selection while the overlay sits open (Codex #333).
  cwd: Option<PathBuf>,
}

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

  /// (Re)populate the picker from a list of profile names + the worktree it
  /// targets, resetting the highlight to the top. Called by the
  /// orchestrator's `enter_exec_picker` each time the overlay opens.
  pub fn open(&mut self, profiles: Vec<String>, cwd: PathBuf) {
    self.profiles = profiles;
    self.selected = 0;
    self.cwd = Some(cwd);
  }

  /// The worktree directory the picker was opened for, if any.
  pub fn cwd(&self) -> Option<&Path> {
    self.cwd.as_deref()
  }

  /// The profile names, in display order.
  pub fn profiles(&self) -> &[String] {
    &self.profiles
  }

  /// `true` when no profiles are loaded (the orchestrator refuses to open
  /// the overlay in this state, but the picker stays well-defined).
  pub fn is_empty(&self) -> bool {
    self.profiles.is_empty()
  }

  /// The highlighted row index (clamped to `profiles`).
  pub fn selected_index(&self) -> usize {
    self.selected
  }

  /// The highlighted profile name, or `None` when the picker is empty.
  pub fn selected_profile(&self) -> Option<&str> {
    self.profiles.get(self.selected).map(String::as_str)
  }

  /// Move the highlight down one row, wrapping to the top. No-op when
  /// empty.
  pub fn next(&mut self) {
    if self.profiles.is_empty() {
      return;
    }
    self.selected = (self.selected + 1) % self.profiles.len();
  }

  /// Move the highlight up one row, wrapping to the bottom. No-op when
  /// empty.
  pub fn prev(&mut self) {
    if self.profiles.is_empty() {
      return;
    }
    self.selected = (self.selected + self.profiles.len() - 1) % self.profiles.len();
  }
}