vig 0.12.0

//! Log sub-pane of a run detail: the selected job's log (`gh run view
//! --log --job`) in the shared `TailPane`. Step boundaries and `##[group]`
//! markers are section lines; `]` / `[` jump between failed steps. Jobs
//! still running are polled every few seconds and the new lines appended.

use super::jobs::LogTarget;
use crate::core::keymap::NavAction;
use crate::core::pane::PaneEvent;
use crate::core::search::SearchMatch;
use crate::core::ui::tail_pane::{TailPane, TailState};
use crate::github::domain::actions::client;
use crate::github::domain::actions::log::{
    decode, failed_step_lines, new_tail, parse_job_log, step_line, LogLine,
};
use crate::github::state::GhBgMessage;
use ratatui::{
    layout::Rect,
    style::{Color, Modifier, Style},
    text::{Line, Span},
    widgets::Block,
    Frame,
};
use std::collections::HashSet;
use std::sync::mpsc;
use std::time::{Duration, Instant};

/// Scrollback cap (GitHub logs can run to tens of thousands of lines).
pub const LOG_CAP: usize = 20_000;

/// State of the Log sub-pane: one job's log buffer and its fetch status.
#[derive(Debug, Clone)]
pub struct LogView {
    pub tail: TailState,
    target: Option<LogTarget>,
    /// Correlates fetch results with the current target; bumped on reload.
    request_id: u64,
    in_flight: bool,
    last_poll: Option<Instant>,
    error: Option<String>,
    /// Step to scroll to once the log has arrived.
    pending_jump: Option<String>,
}

impl Default for LogView {
    fn default() -> Self {
        Self::new()
    }
}

impl LogView {
    pub fn new() -> Self {
        Self {
            tail: TailState::new(LOG_CAP),
            target: None,
            request_id: 0,
            in_flight: false,
            last_poll: None,
            error: None,
            pending_jump: None,
        }
    }

    pub fn target(&self) -> Option<&LogTarget> {
        self.target.as_ref()
    }

    pub fn is_loading(&self) -> bool {
        self.in_flight && self.tail.is_empty()
    }

    /// Title for the sub-pane block.
    pub fn title(&self) -> String {
        match &self.target {
            Some(t) if t.in_progress => {
                format!("Log: {} [{}]", t.job_name, self.tail.mode_label())
            }
            Some(t) => format!("Log: {}", t.job_name),
            None => "Log".to_string(),
        }
    }

    /// Show `target`'s log, scrolling to `step` once loaded. Re-opening the
    /// job that is already shown keeps the buffer and only performs the jump.
    pub fn load(
        &mut self,
        target: LogTarget,
        step: Option<String>,
        tx: &mpsc::Sender<GhBgMessage>,
    ) {
        let same = self
            .target
            .as_ref()
            .is_some_and(|t| t.job_id == target.job_id);
        if same {
            self.target = Some(target);
            match step {
                Some(name) if !self.tail.is_empty() => self.jump_to_step(&name),
                Some(name) => self.pending_jump = Some(name),
                None => {}
            }
            return;
        }
        self.target = Some(target);
        self.pending_jump = step;
        self.restart(tx);
    }

    /// The jobs list was refreshed: pick up the job's new state. A job that
    /// just finished gets one last full fetch so the buffer is complete.
    pub fn update_target(&mut self, latest: LogTarget, tx: &mpsc::Sender<GhBgMessage>) {
        let Some(current) = &self.target else {
            return;
        };
        if current.job_id != latest.job_id {
            return;
        }
        let finished = current.in_progress && !latest.in_progress;
        self.target = Some(latest);
        if finished {
            self.spawn(tx, true);
        }
    }

    /// `r`: drop the buffer and fetch again.
    pub fn refresh(&mut self, tx: &mpsc::Sender<GhBgMessage>) {
        self.restart(tx);
    }

    fn restart(&mut self, tx: &mpsc::Sender<GhBgMessage>) {
        self.tail.clear();
        self.error = None;
        self.in_flight = false;
        self.request_id += 1;
        if self.target.is_some() {
            self.spawn(tx, false);
        }
    }

    /// Poll a running job once per `interval` (`github-poll-interval`).
    pub fn on_tick(&mut self, tx: &mpsc::Sender<GhBgMessage>, interval: Duration) {
        let running = self.target.as_ref().is_some_and(|t| t.in_progress);
        if !running || self.in_flight {
            return;
        }
        let due = self.last_poll.is_none_or(|t| t.elapsed() >= interval);
        if due {
            self.spawn(tx, true);
        }
    }

    fn spawn(&mut self, tx: &mpsc::Sender<GhBgMessage>, append: bool) {
        let Some(target) = &self.target else {
            return;
        };
        let (run_id, job_id, in_progress) = (target.run_id, target.job_id, target.in_progress);
        let request_id = self.request_id;
        self.in_flight = true;
        self.last_poll = Some(Instant::now());
        let tx = tx.clone();
        std::thread::spawn(move || {
            let result =
                client::fetch_job_log(run_id, job_id, in_progress).map(|raw| parse_job_log(&raw));
            let _ = tx.send(GhBgMessage::RunLog {
                request_id,
                append,
                result,
            });
        });
    }

    /// Apply a fetch result; results for a previous target are dropped.
    pub fn apply(&mut self, request_id: u64, append: bool, result: Result<Vec<String>, String>) {
        if request_id != self.request_id {
            return;
        }
        self.in_flight = false;
        match result {
            Ok(lines) => {
                self.error = None;
                if append {
                    match new_tail(self.tail.len(), self.tail.lines(), lines) {
                        Ok(tail) => self.tail.extend(tail),
                        Err(all) => self.tail.set_lines(all),
                    }
                } else {
                    self.tail.set_lines(lines);
                }
                if let Some(name) = self.pending_jump.take() {
                    self.jump_to_step(&name);
                }
            }
            Err(e) => {
                // A job that has not written anything yet is not an error.
                if self.tail.is_empty() && self.target.as_ref().is_some_and(|t| t.in_progress) {
                    self.error = None;
                } else {
                    self.error = Some(e);
                }
            }
        }
    }

    fn jump_to_step(&mut self, name: &str) {
        if let Some(idx) = step_line(self.tail.lines(), name) {
            self.tail.scroll_to(idx);
        }
    }

    /// Header lines of the failed steps, in buffer order.
    fn failed_lines(&self) -> Vec<usize> {
        match &self.target {
            Some(t) => failed_step_lines(self.tail.lines(), &t.failed_steps),
            None => vec![],
        }
    }

    /// `]` / `[`: the next / previous failed step relative to the top of
    /// the view, wrapping around. `]` from the end of the buffer (the
    /// initial follow position) therefore lands on the first failed step.
    pub fn jump_failed(&mut self, forward: bool) -> Vec<PaneEvent> {
        let lines = self.failed_lines();
        if lines.is_empty() {
            return vec![PaneEvent::StatusMessage("No failed steps".to_string())];
        }
        let top = self.tail.top();
        let target = if forward {
            lines.iter().copied().find(|&l| l > top).unwrap_or(lines[0])
        } else {
            lines
                .iter()
                .rev()
                .copied()
                .find(|&l| l < top)
                .unwrap_or(lines[lines.len() - 1])
        };
        self.tail.scroll_to(target);
        let pos = lines.iter().position(|&l| l == target).unwrap_or(0);
        vec![PaneEvent::StatusMessage(format!(
            "Failed step [{}/{}]",
            pos + 1,
            lines.len()
        ))]
    }

    pub fn nav(&mut self, nav: NavAction) {
        self.tail.apply_nav(nav);
    }

    pub fn search_matches(&self, query: &str) -> Vec<SearchMatch> {
        self.tail.search_matches(query)
    }

    pub fn jump_to_match(&mut self, m: &SearchMatch) {
        self.tail.jump_to_match(m);
    }

    /// Render the buffer into `block`.
    pub fn render(
        &mut self,
        f: &mut Frame,
        area: Rect,
        block: Block<'static>,
        match_set: &HashSet<usize>,
        current_match: Option<usize>,
    ) {
        let empty = match (&self.error, &self.target) {
            (Some(e), _) => format!("Error: {e}"),
            (None, None) => "Select a job and press Enter to show its log".to_string(),
            (None, Some(_)) if self.in_flight => "Loading...".to_string(),
            (None, Some(t)) if t.in_progress => "(no output yet)".to_string(),
            (None, Some(_)) => "(empty log)".to_string(),
        };
        TailPane::new(block)
            .empty_message(&empty)
            .highlights(match_set, current_match)
            .formatter(log_line)
            .render(f, area, &mut self.tail);
    }
}

/// Style one buffer line: step and group headers as section lines, dim
/// clocks, red errors and yellow warnings.
fn log_line(raw: &str) -> Line<'static> {
    let dim = Style::default().fg(Color::DarkGray);
    match decode(raw) {
        LogLine::Step(name) => Line::from(vec![
            Span::styled(" ▶ ", Style::default().fg(Color::Cyan)),
            Span::styled(
                name.to_string(),
                Style::default()
                    .fg(Color::Cyan)
                    .add_modifier(Modifier::BOLD),
            ),
        ]),
        LogLine::Group(title) => Line::from(vec![
            Span::styled("   ▸ ", Style::default().fg(Color::Blue)),
            Span::styled(title.to_string(), Style::default().fg(Color::Blue)),
        ]),
        LogLine::Error(msg) => Line::from(vec![
            Span::styled("   ✗ ", Style::default().fg(Color::Red)),
            Span::styled(msg.to_string(), Style::default().fg(Color::Red)),
        ]),
        LogLine::Warning(msg) => Line::from(vec![
            Span::styled("   ! ", Style::default().fg(Color::Yellow)),
            Span::styled(msg.to_string(), Style::default().fg(Color::Yellow)),
        ]),
        LogLine::Text { clock, text } => match clock {
            Some(clock) => Line::from(vec![
                Span::styled(format!(" {clock} "), dim),
                Span::raw(text.to_string()),
            ]),
            None => Line::from(Span::raw(format!(" {text}"))),
        },
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::github::domain::actions::log::encode_step;

    fn target(job_id: u64, in_progress: bool, failed: &[&str]) -> LogTarget {
        LogTarget {
            run_id: 1,
            job_id,
            job_name: format!("job {job_id}"),
            url: String::new(),
            in_progress,
            failed_steps: failed.iter().map(|s| s.to_string()).collect(),
        }
    }

    fn lines() -> Vec<String> {
        vec![
            encode_step("Set up job"),
            "2026-08-28T08:17:27.0000000Z runner".into(),
            encode_step("cargo test"),
            "2026-08-28T08:17:46.0000000Z running".into(),
            "2026-08-28T08:18:11.0000000Z ##[error]exit 101".into(),
            encode_step("cargo build"),
            "2026-08-28T08:18:12.0000000Z ##[error]skipped".into(),
            encode_step("Complete job"),
            "2026-08-28T08:18:13.0000000Z done".into(),
        ]
    }

    #[test]
    fn load_apply_and_stale_requests() {
        let (tx, _rx) = mpsc::channel();
        let mut view = LogView::new();
        assert_eq!(view.title(), "Log");
        view.load(target(10, false, &[]), None, &tx);
        let rid = view.request_id;
        assert!(view.in_flight);
        assert!(view.is_loading());
        assert_eq!(view.title(), "Log: job 10");
        view.apply(rid, false, Ok(lines()));
        assert_eq!(view.tail.len(), 9);
        assert!(!view.in_flight);
        // Re-opening the same job keeps the buffer.
        view.load(target(10, false, &[]), None, &tx);
        assert_eq!(view.request_id, rid);
        assert_eq!(view.tail.len(), 9);
        // Another job starts over; the old result is dropped.
        view.load(target(11, false, &[]), None, &tx);
        assert!(view.tail.is_empty());
        view.apply(rid, false, Ok(lines()));
        assert!(view.tail.is_empty());
        view.apply(view.request_id, false, Err("boom".into()));
        assert_eq!(view.error.as_deref(), Some("boom"));
    }

    #[test]
    fn step_jump_waits_for_the_log() {
        let (tx, _rx) = mpsc::channel();
        let mut view = LogView::new();
        view.tail.set_view_height(3);
        view.load(
            target(10, false, &["cargo test"]),
            Some("cargo build".into()),
            &tx,
        );
        assert_eq!(view.pending_jump.as_deref(), Some("cargo build"));
        view.apply(view.request_id, false, Ok(lines()));
        assert!(view.pending_jump.is_none());
        assert_eq!(view.tail.top(), 5);
        assert!(!view.tail.is_following());
        // Same job, another step: immediate jump.
        view.load(
            target(10, false, &["cargo test"]),
            Some("Set up job".into()),
            &tx,
        );
        assert_eq!(view.tail.top(), 0);
    }

    #[test]
    fn failed_step_jumps_wrap_around() {
        let (tx, _rx) = mpsc::channel();
        let mut view = LogView::new();
        view.tail.set_view_height(3);
        view.load(target(10, false, &["cargo test", "cargo build"]), None, &tx);
        view.apply(view.request_id, false, Ok(lines()));
        // Following the end: `]` lands on the first failed step.
        assert!(view.tail.is_following());
        let ev = view.jump_failed(true);
        assert!(matches!(ev.as_slice(), [PaneEvent::StatusMessage(m)] if m == "Failed step [1/2]"));
        assert_eq!(view.tail.top(), 2);
        view.jump_failed(true);
        assert_eq!(view.tail.top(), 5);
        // Past the last one: wraps to the first.
        view.jump_failed(true);
        assert_eq!(view.tail.top(), 2);
        view.jump_failed(false);
        assert_eq!(view.tail.top(), 5);
        // No failures: a status message, no scroll.
        view.load(target(11, false, &[]), None, &tx);
        view.apply(view.request_id, false, Ok(lines()));
        let ev = view.jump_failed(true);
        assert!(matches!(ev.as_slice(), [PaneEvent::StatusMessage(m)] if m == "No failed steps"));
    }

    #[test]
    fn running_jobs_append_and_finish_with_a_final_fetch() {
        let (tx, rx) = mpsc::channel();
        let mut view = LogView::new();
        view.load(target(10, true, &[]), None, &tx);
        let rid = view.request_id;
        assert_eq!(view.title(), "Log: job 10 [follow]");
        // Nothing written yet is not an error while the job runs.
        view.apply(rid, false, Err("HTTP 404".into()));
        assert!(view.error.is_none());
        view.apply(rid, true, Ok(lines()[..2].to_vec()));
        assert_eq!(view.tail.len(), 2);
        view.apply(rid, true, Ok(lines()[..4].to_vec()));
        assert_eq!(view.tail.len(), 4);
        // A rewritten log replaces the buffer.
        view.apply(rid, true, Ok(vec!["x".into(), "y".into()]));
        assert_eq!(view.tail.len(), 2);
        // Scrolling pauses following; the title says so.
        view.nav(NavAction::MoveUp);
        assert_eq!(view.title(), "Log: job 10 [paused]");
        // The jobs list reports completion: one more fetch is queued.
        drop(rx);
        view.in_flight = false;
        view.update_target(target(10, false, &["cargo test"]), &tx);
        assert!(view.in_flight);
        assert_eq!(view.target().unwrap().failed_steps, ["cargo test"]);
        // Updates for other jobs are ignored.
        view.update_target(target(99, false, &[]), &tx);
        assert_eq!(view.target().unwrap().job_id, 10);
    }

    #[test]
    fn search_matches_are_line_entries() {
        let (tx, _rx) = mpsc::channel();
        let mut view = LogView::new();
        view.tail.set_view_height(3);
        view.load(target(10, false, &[]), None, &tx);
        view.apply(view.request_id, false, Ok(lines()));
        let m = view.search_matches("cargo");
        assert_eq!(m.len(), 2);
        view.jump_to_match(&m[1]);
        assert_eq!(view.tail.top(), 5);
    }
}