Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

30.7 KB
Raw Blame
use super::collect::TaskKind;

/// Logical identifier for each column rendered by `wt list`.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum ColumnKind {
    Gutter, // Type indicator: `@` (current), `^` (main), `+` (worktree), space (branch-only)
    Branch,
    Status, // Includes both git status symbols and user-defined status
    WorkingDiff,
    AheadBehind,
    BranchDiff,
    Summary,
    Upstream,
    CiStatus,
    Path,
    Url, // Dev server URL from project config template
    Commit,
    Time,
    Message,
    /// User-defined column from `[list.custom-columns]`; the index points into the
    /// resolved column list for this invocation. Values are expanded before
    /// layout, so widths are measured from content and headers come from the
    /// resolved name (not [`ColumnKind::header`]).
    Custom(u8),
}

impl ColumnKind {
    /// This column's header text.
    pub const fn header(self) -> &'static str {
        match self {
            ColumnKind::Gutter => "",
            ColumnKind::Branch => "Branch",
            ColumnKind::Status => "Status",
            ColumnKind::WorkingDiff => "HEAD±",
            ColumnKind::AheadBehind => "main↕",
            ColumnKind::BranchDiff => "main…±",
            ColumnKind::Path => "Path",
            ColumnKind::Upstream => "Remote⇅",
            ColumnKind::Url => "URL",
            ColumnKind::Time => "Age",
            ColumnKind::CiStatus => "CI",
            ColumnKind::Commit => "Commit",
            ColumnKind::Summary => "Summary",
            ColumnKind::Message => "Message",
            // Header is the resolved column name; layout substitutes it when
            // building `ColumnLayout`.
            ColumnKind::Custom(_) => "",
        }
    }

    /// Get the base priority for this column (lower = more important).
    ///
    /// Used by both `wt list` layout and statusline truncation to ensure
    /// consistent priority ordering across commands.
    pub fn priority(self) -> u8 {
        COLUMN_SPECS
            .iter()
            .find(|spec| spec.kind == self)
            .map(|spec| spec.base_priority)
            .unwrap_or(u8::MAX)
    }

    /// Canonical kebab identifier for the `[list] columns` selection list.
    ///
    /// `None` for [`ColumnKind::Gutter`] (the worktree-type indicator, always
    /// shown and not user-selectable) and [`ColumnKind::Custom`] (addressed by
    /// its `[list.custom-columns]` header, not a static name). The exhaustive
    /// match forces every new variant to declare a name or opt out, and
    /// `test_config_name_round_trips` guards that the names stay unique and
    /// parseable.
    pub fn config_name(self) -> Option<&'static str> {
        Some(match self {
            ColumnKind::Gutter => return None,
            ColumnKind::Branch => "branch",
            ColumnKind::Status => "status",
            ColumnKind::WorkingDiff => "working-diff",
            ColumnKind::AheadBehind => "ahead-behind",
            ColumnKind::BranchDiff => "branch-diff",
            ColumnKind::Summary => "summary",
            ColumnKind::Upstream => "upstream",
            ColumnKind::CiStatus => "ci",
            ColumnKind::Path => "path",
            ColumnKind::Url => "url",
            ColumnKind::Commit => "commit",
            ColumnKind::Time => "age",
            ColumnKind::Message => "message",
            ColumnKind::Custom(_) => return None,
        })
    }

    /// Resolve a kebab name from `[list] columns` to its built-in column.
    ///
    /// Only built-ins registered in [`COLUMN_SPECS`] are selectable; Gutter
    /// (no name) and custom columns are unreachable here.
    pub fn from_config_name(name: &str) -> Option<ColumnKind> {
        COLUMN_SPECS
            .iter()
            .map(|spec| spec.kind)
            .find(|kind| kind.config_name() == Some(name))
    }

    /// All selectable column names in display order, for error messages and docs.
    pub fn selectable_names() -> Vec<&'static str> {
        COLUMN_SPECS
            .iter()
            .filter_map(|spec| spec.kind.config_name())
            .collect()
    }

    /// Background tasks whose results feed this column.
    ///
    /// The single source of the column→task relationship, in both directions:
    /// [`required_tasks_for_render`] unions it over the rendered columns to
    /// decide which tasks `wt list` runs at all, and [`ColumnKind::renders_given_run`]
    /// reads it to hide a column whose tasks were skipped. So a narrowed view
    /// does less git work rather than computing cells it then hides.
    ///
    /// `Status` aggregates almost every status-feeding task (the five
    /// `refresh_status_symbols` gates); identity columns (Branch, Path, Commit,
    /// Age, Message), the always-on Gutter, and custom columns are derived
    /// without any task.
    ///
    /// Drift guard: `test_required_tasks_cover_every_task` asserts the union
    /// across all built-ins is exactly the full `TaskKind` set, so a new task
    /// (or a new consumer of one) can't silently fall out of the mapping — and
    /// since this map now gates spawning, a task with no consumer would never
    /// run, not merely be computed and discarded.
    pub fn required_tasks(self) -> &'static [TaskKind] {
        match self {
            // Gate 1 (working tree) ← WorkingTreeDiff; gate 2 (operation) ←
            // WorkingTreeDiff + GitOperation; gate 3 (main state) ← AheadBehind,
            // WorkingTreeDiff, MergeTreeConflicts, WorkingTreeConflicts, and the
            // integration signals (CommittedTreesMatch, HasFileChanges,
            // WouldMergeAdd, IsAncestor); gate 4 (upstream) ← Upstream; gate 5
            // (user marker) ← UserMarker. See `model::item::refresh_status_symbols`.
            ColumnKind::Status => &[
                TaskKind::WorkingTreeDiff,
                TaskKind::GitOperation,
                TaskKind::AheadBehind,
                TaskKind::MergeTreeConflicts,
                TaskKind::WorkingTreeConflicts,
                TaskKind::CommittedTreesMatch,
                TaskKind::HasFileChanges,
                TaskKind::WouldMergeAdd,
                TaskKind::IsAncestor,
                TaskKind::Upstream,
                TaskKind::UserMarker,
            ],
            ColumnKind::WorkingDiff => &[TaskKind::WorkingTreeDiff],
            ColumnKind::AheadBehind => &[TaskKind::AheadBehind],
            ColumnKind::BranchDiff => &[TaskKind::BranchDiff],
            ColumnKind::Upstream => &[TaskKind::Upstream],
            ColumnKind::CiStatus => &[TaskKind::CiStatus],
            ColumnKind::Url => &[TaskKind::UrlStatus],
            ColumnKind::Summary => &[TaskKind::SummaryGenerate],
            ColumnKind::Gutter
            | ColumnKind::Branch
            | ColumnKind::Path
            | ColumnKind::Commit
            | ColumnKind::Time
            | ColumnKind::Message
            | ColumnKind::Custom(_) => &[],
        }
    }

    /// Whether this column renders, given the set of tasks that will run.
    ///
    /// A column renders when it consumes no task (identity columns, Gutter,
    /// custom — always shown) or at least one of its tasks is in the run set.
    /// The layout filter applies this to every built-in, dropping any whose
    /// tasks the planner left out: a default-set column gated off by `--full`,
    /// any column whose data source is missing (no template/LLM), or — under a
    /// `[list] columns` selection — an unselected column (whose tasks aren't
    /// planned either, though the separate selection filter also removes it).
    pub fn renders_given_run(self, run: &std::collections::HashSet<TaskKind>) -> bool {
        let required = self.required_tasks();
        required.is_empty() || required.iter().any(|task| run.contains(task))
    }
}

/// Every built-in column, in registry order — the rendered set when no
/// `[list] columns` selection narrows it (and for the picker / JSON, which
/// fetch every field regardless of selection). Custom columns are omitted: they
/// consume no background task, so they never change the task set.
pub fn all_columns() -> impl Iterator<Item = ColumnKind> {
    COLUMN_SPECS.iter().map(|spec| spec.kind)
}

/// Every background task — the full plan, equivalent to rendering every column
/// with all gates open. Test-only: it's the "render everything" plan the
/// picker's single-row layout tests pass. Production `wt list` and statusline
/// derive their plan from the columns they actually show (no blanket "all").
#[cfg(test)]
pub fn all_tasks() -> std::collections::HashSet<TaskKind> {
    use strum::IntoEnumIterator;
    TaskKind::iter().collect()
}

/// Gates that hide a column independent of the `[list] columns` selection.
///
/// Two kinds, distinguished by [`column_renders`]. *Preset* gates (`show_full`,
/// `summary_enabled`) bundle columns into the default table; a column named
/// outright in `[list] columns` overrides them. *Data-source* gates
/// (`has_llm_command`, `has_url_template`) are hard: without the command or
/// template there's nothing to render, so they hold even for a listed column.
#[derive(Clone, Copy, Debug)]
pub struct ColumnGates {
    /// `--full` (or `[list] full`): CI status and LLM summaries join the default
    /// table only with it. A preset — a listed `ci`/`summary` ignores it.
    pub show_full: bool,
    /// `[list] summary`: the summary column is opt-in for the default table even
    /// under `--full`. A preset — a listed `summary` ignores it.
    pub summary_enabled: bool,
    /// An LLM command is configured (`[commit.generation]`). A data source: no
    /// command, no summary, however the column was requested.
    pub has_llm_command: bool,
    /// A `[list] url` template is configured. A data source: no template, no url.
    pub has_url_template: bool,
}

/// How a column entered the rendered set, which decides whether the preset gates
/// apply to it (see [`ColumnGates`]).
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum ColumnSource {
    /// Part of the default set: no `[list] columns`, or the picker/JSON plan over
    /// every column. Every gate applies.
    Default,
    /// Named explicitly in `[list] columns`. The preset gates don't apply; the
    /// data-source gates still do.
    Listed,
}

/// Whether a column renders under `gates`, given how it entered the set.
///
/// A `Listed` column overrides the preset gates (`--full`, `[list] summary`):
/// listing `ci` shows it without `--full`, listing `summary` shows it whenever an
/// LLM command exists. The data-source gates always apply — `summary` needs an
/// LLM command, `url` needs a template — since listing can't supply data that
/// isn't configured. Every other column always renders.
fn column_renders(kind: ColumnKind, source: ColumnSource, gates: &ColumnGates) -> bool {
    let listed = source == ColumnSource::Listed;
    match kind {
        ColumnKind::CiStatus => listed || gates.show_full,
        ColumnKind::Summary => {
            gates.has_llm_command && (listed || (gates.show_full && gates.summary_enabled))
        }
        ColumnKind::Url => gates.has_url_template,
        _ => true,
    }
}

/// The one place that decides which background tasks `wt list` runs.
///
/// `rendered` is the column set the table will lay out, paired with its `source`:
/// the `[list] columns` selection (`Listed`), or [`all_columns`] when nothing
/// narrows it (`Default`). The task set is exactly the union of the
/// [`required_tasks`](ColumnKind::required_tasks) of the columns that survive the
/// gates (`column_renders`) — so a `Listed` `ci` enrols its task without `--full`,
/// while a column whose data source is missing enrols nothing. `collect` stores
/// this set directly on [`CollectOptions::tasks`](super::collect::CollectOptions::tasks);
/// the spawn loops and layout filter consume it as-is, so a task runs iff some
/// rendered column needs it.
pub fn required_tasks_for_render(
    rendered: impl IntoIterator<Item = ColumnKind>,
    source: ColumnSource,
    gates: &ColumnGates,
) -> std::collections::HashSet<TaskKind> {
    rendered
        .into_iter()
        .filter(|&kind| column_renders(kind, source, gates))
        .flat_map(|kind| kind.required_tasks().iter().copied())
        .collect()
}

/// Parse the `[list] columns` selection into an ordered list of columns.
///
/// Each name resolves to a built-in column (by its kebab
/// [`ColumnKind::config_name`]) or, failing that, to a custom column by its
/// `[list.custom-columns]` header. `custom_names` lists the resolved custom
/// headers in display order, so the matched position becomes
/// [`ColumnKind::Custom`]`(i)` — callers must pass the same order the resolved
/// custom columns use, since that index addresses them downstream. Built-ins
/// win on a name collision: a custom column whose header equals a built-in name
/// (e.g. `branch`) is shadowed and unreachable here.
///
/// An empty input yields an empty selection (the caller treats that as "use the
/// default column set"). Unknown names and duplicates are hard errors so a typo
/// can't silently render a different table; the error lists every valid name.
/// Like `[list.custom-columns]`, this is validated at the `wt list` edge rather
/// than at config load — `ColumnKind` lives in the command layer, out of reach
/// of the config crate.
pub fn parse_selected_columns(
    names: &[String],
    custom_names: &[&str],
) -> anyhow::Result<Vec<ColumnKind>> {
    let mut selected = Vec::with_capacity(names.len());
    for name in names {
        let kind = resolve_column_name(name, custom_names).ok_or_else(|| {
            let mut valid = ColumnKind::selectable_names().join(", ");
            if !custom_names.is_empty() {
                valid.push_str("; custom columns: ");
                valid.push_str(&custom_names.join(", "));
            }
            anyhow::anyhow!("Unknown column {name:?} in [list] columns. Valid columns: {valid}")
        })?;
        if selected.contains(&kind) {
            anyhow::bail!("Duplicate column {name:?} in [list] columns");
        }
        selected.push(kind);
    }
    Ok(selected)
}

/// Resolve one `[list] columns` name to a built-in or custom column.
///
/// Built-ins take precedence, so a custom header colliding with a built-in name
/// is shadowed. The custom index is the name's position in `custom_names`, which
/// mirrors the resolved custom-column order.
fn resolve_column_name(name: &str, custom_names: &[&str]) -> Option<ColumnKind> {
    if let Some(kind) = ColumnKind::from_config_name(name) {
        return Some(kind);
    }
    custom_names
        .iter()
        .position(|custom| *custom == name)
        .map(|i| ColumnKind::Custom(i as u8))
}

/// Differentiates between diff-style columns with plus/minus symbols and those with arrows.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum DiffVariant {
    Signs,
    /// Simple arrows (↑↓) for commits ahead/behind main
    Arrows,
    /// Double-struck arrows (⇡⇣) for commits ahead/behind remote
    UpstreamArrows,
}

/// Static metadata describing a column's behavior in both layout and rendering.
#[derive(Clone, Copy, Debug)]
pub struct ColumnSpec {
    pub kind: ColumnKind,
    pub base_priority: u8,
    /// If true, the column can shrink below its ideal width (down to header width)
    /// instead of being dropped entirely when space is tight.
    pub shrinkable: bool,
}

impl ColumnSpec {
    pub const fn new(kind: ColumnKind, base_priority: u8) -> Self {
        Self {
            kind,
            base_priority,
            shrinkable: false,
        }
    }

    pub const fn shrinkable(mut self) -> Self {
        self.shrinkable = true;
        self
    }
}

/// Static registry of all possible columns in display order.
///
/// Note: base_priority determines truncation order (lower = kept longer),
/// which is independent of display order (position in array).
pub const COLUMN_SPECS: &[ColumnSpec] = &[
    ColumnSpec::new(ColumnKind::Gutter, 0),
    ColumnSpec::new(ColumnKind::Branch, 1).shrinkable(),
    ColumnSpec::new(ColumnKind::Status, 2),
    ColumnSpec::new(ColumnKind::WorkingDiff, 3),
    ColumnSpec::new(ColumnKind::AheadBehind, 4),
    ColumnSpec::new(ColumnKind::BranchDiff, 6),
    ColumnSpec::new(ColumnKind::Summary, 10),
    ColumnSpec::new(ColumnKind::Upstream, 8),
    ColumnSpec::new(ColumnKind::CiStatus, 5),
    ColumnSpec::new(ColumnKind::Path, 7),
    ColumnSpec::new(ColumnKind::Url, 9),
    ColumnSpec::new(ColumnKind::Commit, 11),
    ColumnSpec::new(ColumnKind::Time, 12),
    ColumnSpec::new(ColumnKind::Message, 13),
];

/// Sort key for display order: (slot in `COLUMN_SPECS`, sub-order).
///
/// Custom columns share the Url slot with a non-zero sub-order, so they
/// render after Url and before Commit, in their resolution order.
pub fn column_display_index(kind: ColumnKind) -> (usize, usize) {
    if let ColumnKind::Custom(i) = kind {
        let url_slot = COLUMN_SPECS
            .iter()
            .position(|spec| spec.kind == ColumnKind::Url)
            .unwrap_or(usize::MAX);
        return (url_slot, i as usize + 1);
    }
    let slot = COLUMN_SPECS
        .iter()
        .position(|spec| spec.kind == kind)
        .unwrap_or(usize::MAX);
    (slot, 0)
}

#[cfg(test)]
mod tests {
    use super::*;
    use std::collections::HashSet;

    #[test]
    fn columns_are_ordered_and_unique() {
        let kinds: Vec<ColumnKind> = COLUMN_SPECS.iter().map(|c| c.kind).collect();
        let expected = vec![
            ColumnKind::Gutter,
            ColumnKind::Branch,
            ColumnKind::Status,
            ColumnKind::WorkingDiff,
            ColumnKind::AheadBehind,
            ColumnKind::BranchDiff,
            ColumnKind::Summary,
            ColumnKind::Upstream,
            ColumnKind::CiStatus,
            ColumnKind::Path,
            ColumnKind::Url,
            ColumnKind::Commit,
            ColumnKind::Time,
            ColumnKind::Message,
        ];
        assert_eq!(kinds, expected, "column order should match display layout");
    }

    #[test]
    fn test_renders_given_run() {
        // The layout filter renders a column iff at least one of its tasks is in
        // the run set (or it consumes none). With every task running, every
        // column renders.
        let all = all_tasks();
        for spec in COLUMN_SPECS {
            assert!(
                spec.kind.renders_given_run(&all),
                "{:?} should render when every task runs",
                spec.kind
            );
        }

        // Drop one gated task from the plan: only its own column stops
        // rendering; identity columns (no task) are untouched.
        let mut without_ci = all.clone();
        without_ci.remove(&TaskKind::CiStatus);
        assert!(!ColumnKind::CiStatus.renders_given_run(&without_ci));
        assert!(ColumnKind::Branch.renders_given_run(&without_ci));

        // Status renders while any of its many signals is planned, and drops
        // only when none of them is. CiStatus is not one of its signals.
        let one_status_signal: HashSet<TaskKind> = [TaskKind::AheadBehind].into_iter().collect();
        assert!(ColumnKind::Status.renders_given_run(&one_status_signal));
        let no_status_signal: HashSet<TaskKind> = [TaskKind::CiStatus].into_iter().collect();
        assert!(!ColumnKind::Status.renders_given_run(&no_status_signal));

        // An identity column renders even with an empty run set.
        assert!(ColumnKind::Branch.renders_given_run(&HashSet::new()));
    }

    #[test]
    fn test_column_specs_priorities_are_unique() {
        // Each column should have a unique base_priority
        let priorities: Vec<u8> = COLUMN_SPECS.iter().map(|c| c.base_priority).collect();
        let unique: HashSet<u8> = priorities.iter().cloned().collect();
        assert_eq!(
            priorities.len(),
            unique.len(),
            "base_priority values should be unique"
        );
    }

    #[test]
    fn test_column_specs_headers_are_non_empty() {
        // All columns except Gutter should have non-empty headers
        for kind in COLUMN_SPECS.iter().map(|spec| spec.kind) {
            if kind != ColumnKind::Gutter {
                assert!(
                    !kind.header().is_empty(),
                    "{:?} should have a non-empty header",
                    kind
                );
            }
        }
    }

    #[test]
    fn test_all_column_kinds_have_priority() {
        // Every ColumnKind variant must be in COLUMN_SPECS so priority() works correctly.
        // If this fails, a new variant was added but not registered in COLUMN_SPECS.
        let all_kinds = [
            ColumnKind::Gutter,
            ColumnKind::Branch,
            ColumnKind::Status,
            ColumnKind::WorkingDiff,
            ColumnKind::AheadBehind,
            ColumnKind::BranchDiff,
            ColumnKind::Path,
            ColumnKind::Upstream,
            ColumnKind::Url,
            ColumnKind::CiStatus,
            ColumnKind::Commit,
            ColumnKind::Time,
            ColumnKind::Summary,
            ColumnKind::Message,
        ];

        for kind in all_kinds {
            let priority = kind.priority();
            assert!(
                priority != u8::MAX,
                "{:?} not found in COLUMN_SPECS (priority returned u8::MAX)",
                kind
            );
        }
    }

    #[test]
    fn test_custom_columns_display_between_url_and_commit() {
        let url = column_display_index(ColumnKind::Url);
        let commit = column_display_index(ColumnKind::Commit);
        let first = column_display_index(ColumnKind::Custom(0));
        let second = column_display_index(ColumnKind::Custom(1));
        assert!(url < first, "custom columns render after Url");
        assert!(first < second, "custom columns keep resolution order");
        assert!(second < commit, "custom columns render before Commit");
    }

    #[test]
    fn test_config_name_round_trips() {
        // Drives off COLUMN_SPECS (single source of truth): every registered
        // built-in either has a unique, parseable name or is Gutter. A new
        // variant added to COLUMN_SPECS without a config_name arm fails the
        // exhaustive match in config_name() at compile time; one set to None
        // (other than Gutter) or colliding with another name fails here.
        for spec in COLUMN_SPECS {
            let kind = spec.kind;
            match kind.config_name() {
                Some(name) => assert_eq!(
                    ColumnKind::from_config_name(name),
                    Some(kind),
                    "{kind:?} name {name:?} must round-trip (unique + parseable)"
                ),
                None => assert_eq!(
                    kind,
                    ColumnKind::Gutter,
                    "only Gutter may lack a config_name; {kind:?} is missing one"
                ),
            }
        }
        // Custom columns are addressed by header, never by a static name.
        assert_eq!(ColumnKind::Custom(0).config_name(), None);
        assert_eq!(ColumnKind::from_config_name("gutter"), None);
        assert_eq!(ColumnKind::from_config_name("nonsense"), None);
    }

    #[test]
    fn test_parse_selected_columns() {
        let selected =
            parse_selected_columns(&["ci".into(), "branch".into(), "path".into()], &[]).unwrap();
        assert_eq!(
            selected,
            vec![ColumnKind::CiStatus, ColumnKind::Branch, ColumnKind::Path],
            "selection preserves the configured order"
        );

        assert!(parse_selected_columns(&[], &[]).unwrap().is_empty());

        let unknown = parse_selected_columns(&["branch".into(), "bogus".into()], &[]).unwrap_err();
        assert!(unknown.to_string().contains("Unknown column"), "{unknown}");
        assert!(unknown.to_string().contains("bogus"), "{unknown}");
        // The error lists valid names so a typo is self-correcting.
        assert!(unknown.to_string().contains("ci"), "{unknown}");

        let dup = parse_selected_columns(&["branch".into(), "branch".into()], &[]).unwrap_err();
        assert!(dup.to_string().contains("Duplicate column"), "{dup}");

        // Gutter is structural and not user-selectable.
        let gutter = parse_selected_columns(&["gutter".into()], &[]).unwrap_err();
        assert!(gutter.to_string().contains("Unknown column"), "{gutter}");

        // Matching is exact: the rendered header "Branch" is not the kebab name.
        let cased = parse_selected_columns(&["Branch".into()], &[]).unwrap_err();
        assert!(cased.to_string().contains("Unknown column"), "{cased}");
    }

    #[test]
    fn test_required_tasks_cover_every_task() {
        use strum::IntoEnumIterator;

        // Every TaskKind must feed at least one built-in column. Otherwise a
        // task is either dead work (computed, rendered nowhere) or a missing
        // entry in `required_tasks()` that selection-driven pruning would skip
        // while its consuming column is shown. The union is checked exactly
        // equal so the mapping can't drift in either direction as tasks or
        // columns are added.
        let covered: HashSet<TaskKind> = COLUMN_SPECS
            .iter()
            .flat_map(|spec| spec.kind.required_tasks().iter().copied())
            .collect();
        let all: HashSet<TaskKind> = TaskKind::iter().collect();
        assert_eq!(
            covered, all,
            "required_tasks() union must equal the full TaskKind set"
        );
    }

    #[test]
    fn test_required_tasks_for_render() {
        use ColumnSource::{Default, Listed};
        use strum::IntoEnumIterator;

        // Every gate open: every column can render.
        let open = ColumnGates {
            show_full: true,
            summary_enabled: true,
            has_llm_command: true,
            has_url_template: true,
        };
        let all: HashSet<TaskKind> = TaskKind::iter().collect();

        // The default set (all built-ins) under open gates needs every task —
        // the planner is exhaustive, so nothing falls out silently.
        assert_eq!(
            required_tasks_for_render(all_columns(), Default, &open),
            all
        );

        // A branch/path `ls` view needs no background task at all.
        assert!(
            required_tasks_for_render([ColumnKind::Branch, ColumnKind::Path], Default, &open)
                .is_empty(),
            "identity columns need no task"
        );

        // Selecting Status keeps every status-feeding task; the independent
        // columns' tasks are not pulled in.
        let status = required_tasks_for_render([ColumnKind::Status], Listed, &open);
        assert!(status.contains(&TaskKind::AheadBehind));
        assert!(status.contains(&TaskKind::WorkingTreeDiff));
        assert!(!status.contains(&TaskKind::BranchDiff));
        assert!(!status.contains(&TaskKind::CiStatus));

        // A custom column consumes no task, like the identity columns.
        assert!(required_tasks_for_render([ColumnKind::Custom(0)], Listed, &open).is_empty());

        // `ci`'s only gate is the `--full` preset: hidden in the default set
        // without it, forced on when listed.
        let no_full = ColumnGates {
            show_full: false,
            ..open
        };
        assert!(
            required_tasks_for_render([ColumnKind::CiStatus], Default, &no_full).is_empty(),
            "ci stays off in the default set without --full"
        );
        assert_eq!(
            required_tasks_for_render([ColumnKind::CiStatus], Listed, &no_full),
            HashSet::from([TaskKind::CiStatus]),
            "listing ci forces it on without --full"
        );

        // `summary`'s presets (`--full`, `[list] summary`) gate the default set
        // but yield to a listing; its LLM command is a data source that doesn't.
        for preset_off in [
            ColumnGates {
                show_full: false,
                ..open
            },
            ColumnGates {
                summary_enabled: false,
                ..open
            },
        ] {
            assert!(
                required_tasks_for_render([ColumnKind::Summary], Default, &preset_off).is_empty(),
                "summary stays off in the default set when a preset is off"
            );
            assert_eq!(
                required_tasks_for_render([ColumnKind::Summary], Listed, &preset_off),
                HashSet::from([TaskKind::SummaryGenerate]),
                "listing summary overrides the preset gate"
            );
        }
        let no_llm = ColumnGates {
            has_llm_command: false,
            ..open
        };
        assert!(
            required_tasks_for_render([ColumnKind::Summary], Listed, &no_llm).is_empty(),
            "summary needs an LLM command even when listed"
        );

        // `url`'s template is a data source, gating even a listed column.
        let no_template = ColumnGates {
            has_url_template: false,
            ..open
        };
        assert!(
            required_tasks_for_render([ColumnKind::Url], Listed, &no_template).is_empty(),
            "url needs a template even when listed"
        );

        // Every precondition holding, a listed summary runs.
        assert_eq!(
            required_tasks_for_render([ColumnKind::Summary], Listed, &open),
            HashSet::from([TaskKind::SummaryGenerate]),
            "summary runs when every precondition holds"
        );
    }

    #[test]
    fn test_parse_selected_columns_with_custom() {
        // Custom columns are selectable by header, mixed freely with built-ins,
        // and resolve to Custom(index) in the resolved custom order.
        let selected = parse_selected_columns(
            &[
                "branch".into(),
                "Ticket".into(),
                "ci".into(),
                "Owner".into(),
            ],
            &["Ticket", "Owner"],
        )
        .unwrap();
        assert_eq!(
            selected,
            vec![
                ColumnKind::Branch,
                ColumnKind::Custom(0),
                ColumnKind::CiStatus,
                ColumnKind::Custom(1),
            ],
            "custom headers resolve to Custom(index) in resolved order"
        );

        // A custom header colliding with a built-in name is shadowed by the built-in.
        let shadowed = parse_selected_columns(&["branch".into()], &["branch"]).unwrap();
        assert_eq!(
            shadowed,
            vec![ColumnKind::Branch],
            "built-in wins over a same-named custom column"
        );

        // Selecting the same custom twice errors like any duplicate.
        let dup =
            parse_selected_columns(&["Ticket".into(), "Ticket".into()], &["Ticket"]).unwrap_err();
        assert!(dup.to_string().contains("Duplicate column"), "{dup}");

        // An unknown name lists the configured custom headers so the typo is fixable.
        let unknown = parse_selected_columns(&["Tickte".into()], &["Ticket"]).unwrap_err();
        assert!(unknown.to_string().contains("Unknown column"), "{unknown}");
        assert!(unknown.to_string().contains("Ticket"), "{unknown}");
    }
}