cliban 0.16.0

//! `cliban activity` — what changed on the board, newest first.
//!
//! Answers "what happened since yesterday?" without making the caller diff two
//! `issue ls` runs. Two kinds of event are merged into one time-ordered feed:
//!
//! - **state** — an issue was `created` and/or `completed` in the window, or
//!   failing both, `updated`. `updated` is strictly the fallback, so nothing
//!   is reported twice for one change.
//! - **recorded** — what cliban wrote down for itself as it worked: `status`
//!   moves, `archive`, field `edit`s, `plan` ticks and promotions, and the
//!   `log` notes an author wrote. Attributed to `$CLIBAN_ACTOR` when set.
//! - **log** (unrecorded) — a `## Activity Log` line with no matching record:
//!   hand-written, or predating automatic recording.

use std::collections::HashMap;

use serde_json::{json, Map, Value};

use chrono::{DateTime, Utc};
use cliban_core::contexts::issues::ListOpts;
use cliban_core::contexts::{activity_log, issues, milestones, projects};
use cliban_core::schema::{ActivityLogEntry, Issue};
use cliban_core::time::{format_usec, relative};

use crate::brief::elide;
use crate::descmd;
use crate::errors::CliResult;
use crate::store_open;

/// Compact timestamp for the text feed — minute precision is plenty for
/// scanning, and it matches how `## Activity Log` entries are written.
const FEED_TIME_FORMAT: &str = "%Y-%m-%dT%H:%MZ";

/// Character budget for the trailing text column of the human feed.
const TEXT_WIDTH: usize = 110;

#[derive(clap::Args)]
pub struct ActivityArgs {
    /// how far back to look: 4h, 3d, 2w, today, yesterday, 2026-07-25,
    /// RFC3339 (default: 1d; with --issue: all history)
    #[arg(long)]
    since: Option<String>,
    /// project key filter (default: $CLIBAN_PROJECT; -p '*' = all)
    #[arg(long, short = 'p')]
    project: Option<String>,
    /// milestone name filter
    #[arg(long, short = 'm')]
    milestone: Option<String>,
    /// one issue's full merged history (recorded events + hand-written
    /// ## Activity Log lines)
    #[arg(long)]
    issue: Option<String>,
    /// include archived issues
    #[arg(long)]
    archived: bool,
    /// cap the number of events (0 = no cap; default 15, or 0 with --issue)
    #[arg(long)]
    limit: Option<i64>,
    /// NDJSON output (one compact JSON object per line)
    #[arg(long)]
    json: bool,
    /// human output (overrides $CLIBAN_OUTPUT and pipe detection)
    #[arg(long, conflicts_with = "json")]
    table: bool,
    /// short plain-text summary for reading aloud or pasting into a prompt
    #[arg(long, conflicts_with_all = ["json", "table"])]
    brief: bool,
}

struct Event {
    ts: DateTime<Utc>,
    key: String,
    project: String,
    /// `created` | `completed` | `updated` for derived state events; for a
    /// recorded entry, whatever kind it was recorded under (`status`,
    /// `archive`, `edit`, `plan`, `log`).
    kind: String,
    /// The issue's status *now*, not at the time of the event — context for a
    /// log line, not a historical claim. Transitions are in `message`.
    status: String,
    title: String,
    milestone: Option<String>,
    /// Who did it, when `$CLIBAN_ACTOR` was set at the time. Only recorded
    /// entries carry this.
    actor: Option<String>,
    /// The log line's prose; `None` for state events.
    message: Option<String>,
}

impl Event {
    /// The trailing column: the prose (or title), prefixed with who did it.
    fn text(&self) -> String {
        let body = self.message.as_deref().unwrap_or(&self.title);
        match &self.actor {
            Some(a) => format!("[{a}] {body}"),
            None => body.to_string(),
        }
    }
}

pub async fn run(db: &Option<String>, a: ActivityArgs) -> CliResult<()> {
    // --issue flips the defaults from "the recent board" to "this ticket's
    // whole story": all history, no cap. Explicit --since/--limit still win.
    let since_str = a.since.clone().unwrap_or_else(|| {
        if a.issue.is_some() {
            "1970-01-01".to_string()
        } else {
            "1d".to_string()
        }
    });
    let since = crate::since::parse(&since_str, "--since")?;
    let limit = a.limit.unwrap_or(if a.issue.is_some() { 0 } else { 15 });
    let issue_key = a.issue.as_deref().map(str::to_uppercase);
    let project = crate::scope::project(a.project.clone());
    let store = store_open::open(db).await?;

    let (list_project, list_milestone, archived) =
        (project.clone(), a.milestone.clone(), a.archived);
    // The audit entries cliban recorded for itself, keyed by issue so the
    // per-issue merge below is a lookup rather than a scan.
    let recorded = store
        .call(move |conn| activity_log::list_since(conn, since))
        .await?;
    let mut by_issue: HashMap<i64, Vec<&ActivityLogEntry>> = HashMap::new();
    for entry in &recorded {
        by_issue.entry(entry.issue_id).or_default().push(entry);
    }

    let rows = store
        .call(move |conn| {
            // `ListOpts.archived` is an exact match, but `--archived` means
            // *include* archived here exactly as it does on `issue ls`, so
            // when set we fetch both sets and merge.
            let mut list = issues::list(
                conn,
                ListOpts {
                    project: list_project.as_deref(),
                    milestone: list_milestone.as_deref(),
                    archived: false,
                    ..Default::default()
                },
            )?;
            if archived {
                list.extend(issues::list(
                    conn,
                    ListOpts {
                        project: list_project.as_deref(),
                        milestone: list_milestone.as_deref(),
                        archived: true,
                        ..Default::default()
                    },
                )?);
            }
            // Resolve the display refs here, inside the one store call, rather
            // than issuing a lookup per issue from the async side.
            let mut out = Vec::with_capacity(list.len());
            for i in list {
                let project_key = projects::get_by_id(conn, i.project_id)?
                    .map(|p| p.key)
                    .unwrap_or_default();
                let milestone = match i.milestone_id {
                    Some(id) => milestones::get_by_id(conn, id)?.map(|m| m.name),
                    None => None,
                };
                out.push((i, project_key, milestone));
            }
            Ok(out)
        })
        .await?;

    let mut events = Vec::new();
    for (issue, project_key, milestone) in &rows {
        events.extend(events_for(
            issue,
            project_key,
            milestone.as_deref(),
            since,
            by_issue.get(&issue.id).map(Vec::as_slice).unwrap_or(&[]),
        ));
    }
    if let Some(k) = &issue_key {
        events.retain(|e| &e.key == k);
    }
    // Newest first; ties broken by key so the output is deterministic.
    events.sort_by(|a, b| b.ts.cmp(&a.ts).then_with(|| a.key.cmp(&b.key)));
    if limit > 0 {
        events.truncate(limit as usize);
    }

    let now = Utc::now();
    if a.brief {
        let evs: Vec<_> = events
            .iter()
            // No actor prefix: session ids do not read aloud.
            .map(|e| {
                let text = match (e.kind.as_str(), &e.message) {
                    ("created" | "completed", None) => {
                        format!("{} was {}: {}", e.key, e.kind, e.title.trim_end_matches('.'))
                    }
                    (_, m) => format!("{}: {}", e.key, m.as_deref().unwrap_or(&e.title)),
                };
                (e.ts, text)
            })
            .collect();
        print!("{}", crate::brief::feed(&since_str, &evs, now));
        return Ok(());
    }
    if crate::output::mode(a.json, a.table).is_json() {
        for e in &events {
            println!("{}", serde_json::to_string(&event_json(e)).unwrap());
        }
        return Ok(());
    }
    if events.is_empty() {
        println!("no activity since {since_str}");
        return Ok(());
    }
    let key_width = events
        .iter()
        .map(|e| e.key.chars().count())
        .max()
        .unwrap_or(8)
        .max(8);
    for e in &events {
        println!(
            "{}  {:<key_width$}  {:<9}  {:<11}  {}",
            e.ts.format(FEED_TIME_FORMAT),
            e.key,
            e.kind,
            e.status,
            // Log prose runs long; the feed stays scannable and `--json`
            // carries the untruncated text.
            elide(&e.text(), TEXT_WIDTH),
        );
    }
    eprintln!(
        "— {} event(s) since {} ({})",
        events.len(),
        since_str,
        relative(since, now)
    );
    Ok(())
}

/// Every in-window event for one issue: its state change, the audit entries
/// cliban recorded, and the prose its author logged.
fn events_for(
    issue: &Issue,
    project: &str,
    milestone: Option<&str>,
    since: DateTime<Utc>,
    recorded: &[&ActivityLogEntry],
) -> Vec<Event> {
    let make = |ts: DateTime<Utc>, kind: &str, message: Option<String>| Event {
        ts,
        key: issue.key.clone(),
        project: project.to_string(),
        kind: kind.to_string(),
        status: issue.status.clone(),
        title: issue.title.clone(),
        milestone: milestone.map(str::to_string),
        actor: None,
        message,
    };

    let mut out = Vec::new();
    // `created` and `completed` are distinct facts and both get reported —
    // an issue opened and finished inside the window did both, and dropping
    // either misreads the window. `updated` is only the fallback for a change
    // neither of them already explains, so nothing double-counts.
    if issue.inserted_at >= since {
        out.push(make(issue.inserted_at, "created", None));
    }
    if let Some(done) = issue.completed_at.filter(|t| *t >= since) {
        out.push(make(done, "completed", None));
    }
    if out.is_empty() && issue.updated_at >= since {
        out.push(make(issue.updated_at, "updated", None));
    }
    // What cliban recorded on its own: status moves, archiving, field edits,
    // plan ticks and promotions. The recorded kind passes straight through so
    // a caller can filter on it.
    for entry in recorded {
        let mut e = make(entry.ts, &entry.kind, Some(entry.message.clone()));
        e.actor = crate::audit::actor_of(&entry.extra);
        out.push(e);
    }
    // …and the narrative its author wrote with `cliban issue log`. Those are
    // recorded in both places, so skip any markdown line that a recorded entry
    // already covers; what survives here is hand-written or pre-dates
    // recording.
    let already: std::collections::HashSet<(i64, String)> = recorded
        .iter()
        .filter(|e| e.kind == "log")
        .map(|e| crate::audit::log_dedupe_key(e.ts, &e.message))
        .collect();
    for (ts, message) in descmd::parse_activity_log(&issue.description) {
        if ts >= since && !already.contains(&crate::audit::log_dedupe_key(ts, &message)) {
            out.push(make(ts, "log", Some(message)));
        }
    }
    out
}

/// One event, on the list-row diet: absent means null. `issue_status` (the
/// issue's status *now*, repeated on every historical row) was cut outright —
/// current state is one `issue ls` away, and transitions live in `message`.
/// `ts` is second precision; the microsecond original only orders the feed.
fn event_json(e: &Event) -> Value {
    let mut m = Map::new();
    if let Some(a) = &e.actor {
        m.insert("actor".into(), json!(a));
    }
    m.insert("key".into(), json!(e.key));
    m.insert("kind".into(), json!(e.kind));
    if let Some(msg) = &e.message {
        m.insert("message".into(), json!(msg));
    }
    if let Some(ms) = &e.milestone {
        m.insert("milestone".into(), json!(ms));
    }
    m.insert("project".into(), json!(e.project));
    m.insert("title".into(), json!(e.title));
    m.insert(
        "ts".into(),
        json!(crate::output::trim_usec(&format_usec(e.ts))),
    );
    Value::Object(m)
}