mkit-cli 0.4.1

//! `mkit show [<object>...]` — display objects (default `HEAD`).
//!
//! Mirrors `git show`:
//! - **commit** / **remix**: a header (`commit <hash>` / `Author` / `Date` /
//!   indented message, matching `mkit log`) followed by the unified diff
//!   against its first parent. The diff body is produced by the same code as
//!   `mkit diff`, so `show <commit>` is byte-identical to
//!   `diff <parent> <commit>` (modulo the abbreviated `index` ids).
//! - **tag**: the tag header, then the peeled target object.
//! - **tree**: an `ls-tree`-style listing.
//! - **blob**: the raw contents.
//!
//! Like `mkit log`, the commit/tag headers carry mkit's signed `Identity`
//! and 64-hex BLAKE3 ids, so the header lines diverge from git's
//! `Author: Name <email>` / 40-hex form — the same documented divergence as
//! `log`. The diff body, tree listing, and blob output match git.

use std::io::Write;

use clap::Parser;
use mkit_core::hash::Hash;
use mkit_core::object::{Identity, Object, Tag};
use mkit_core::ops::diff_trees;
use mkit_core::store::{DisplaySource, ObjectStore};
use mkit_core::worktree;

use super::revspec;
use crate::clap_shim;
use crate::exit;
use crate::format;

/// Bound on tag-of-tag recursion, mirroring `diff`/`log`'s peel depth.
const MAX_TAG_DEPTH: usize = 16;

#[derive(Debug, Parser)]
#[command(
    name = "mkit show",
    about = "Display objects (default HEAD): commits with their diff, tags, trees, blobs."
)]
struct ShowOpts {
    /// Show a diffstat instead of the full patch for commit/remix objects
    /// (like `git show --stat`): per-file changed-line counts, a `+`/`-`
    /// graph, and a summary line. Non-commit objects are shown as usual.
    #[arg(long)]
    stat: bool,
    /// Objects to show — revisions, refs, or hashes (e.g. `HEAD`, `main`,
    /// `HEAD~2`, `<hash>`, `<tag>`). Defaults to `HEAD`.
    objects: Vec<String>,
}

#[must_use]
pub fn run(args: &[String]) -> u8 {
    let opts = match clap_shim::parse::<ShowOpts>("mkit show", args) {
        Ok(o) => o,
        Err(code) => return code,
    };
    let cwd = match std::env::current_dir() {
        Ok(p) => p,
        Err(e) => return emit_err(&format!("cwd: {e}"), exit::NOINPUT),
    };
    let layout = match super::resolve_layout(&cwd) {
        Ok(layout) => layout,
        Err(code) => return code,
    };
    let store = match ObjectStore::open(&layout) {
        Ok(s) => s,
        Err(e) => return emit_err(&format!("not a mkit repo: {e}"), exit::GENERAL_ERROR),
    };

    let specs: Vec<String> = if opts.objects.is_empty() {
        vec!["HEAD".to_string()]
    } else {
        opts.objects.clone()
    };

    let mut stdout = std::io::stdout().lock();
    for spec in &specs {
        let h = match revspec::resolve_revision(&store, &layout, spec) {
            Ok(h) => h,
            Err(e) => return emit_err(&e.to_string(), exit::GENERAL_ERROR),
        };
        if let Err((msg, code)) = show_object(&mut stdout, &store, &h, 0, opts.stat) {
            return emit_err(&msg, code);
        }
    }
    exit::OK
}

/// Display one object. `tag_depth` bounds tag-of-tag recursion.
fn show_object(
    out: &mut impl Write,
    store: &ObjectStore,
    h: &Hash,
    tag_depth: usize,
    stat: bool,
) -> Result<(), (String, u8)> {
    let obj = store
        .read_object(h)
        .map_err(|e| (format!("read object: {e}"), exit::GENERAL_ERROR))?;
    match obj {
        Object::Commit(c) => show_commit_like(
            out,
            store,
            h,
            "commit",
            &c.author,
            c.timestamp,
            &c.message,
            c.parents.first().copied(),
            c.tree_hash,
            stat,
        ),
        Object::Remix(r) => show_commit_like(
            out,
            store,
            h,
            "remix",
            &r.author,
            r.timestamp,
            &r.message,
            r.parents.first().copied(),
            r.tree_hash,
            stat,
        ),
        Object::Tag(t) => show_tag(out, store, &t, tag_depth, stat),
        Object::Tree(t) => {
            for e in &t.entries {
                let (mode, ty) = super::cat_file::git_mode_and_type(e.mode);
                let _ = writeln!(
                    out,
                    "{mode} {ty} {}\t{}",
                    format::hex_hash(&e.object_hash),
                    String::from_utf8_lossy(&e.name)
                );
            }
            Ok(())
        }
        Object::Blob(b) => {
            let _ = out.write_all(&b.data);
            Ok(())
        }
        Object::ChunkedBlob(_) => {
            let data = worktree::read_blob(store, h)
                .map_err(|e| (format!("reassemble: {e}"), exit::GENERAL_ERROR))?;
            let _ = out.write_all(&data);
            Ok(())
        }
        // `Delta` is a pack-only encoding and never the result of a plain
        // `read_object`, but handle it explicitly rather than via a wildcard.
        Object::Delta(_) => Err(("cannot show a delta object".to_string(), exit::DATAERR)),
    }
}

/// Render a commit or remix: a `mkit log`-style header followed by the
/// unified diff against the first parent (an empty tree for a root commit).
#[allow(clippy::too_many_arguments)]
fn show_commit_like(
    out: &mut impl Write,
    store: &ObjectStore,
    hash: &Hash,
    label: &str,
    author: &Identity,
    timestamp: u64,
    message: &[u8],
    parent: Option<Hash>,
    tree: Hash,
    stat: bool,
) -> Result<(), (String, u8)> {
    let _ = writeln!(out, "{label} {}", format::hex_hash(hash));
    let _ = writeln!(out, "Author: {}", format::short_identity(author));
    let _ = writeln!(out, "Date:   {}", format::human_date_utc(timestamp));
    let _ = writeln!(out);
    write_indented_message(out, message);
    let _ = writeln!(out);

    // Diff the first parent's tree against this tree (None ⇒ empty, so a
    // root commit shows every file as added), reusing `diff`'s renderer.
    let parent_tree = match parent {
        Some(p) => {
            Some(super::diff::object_to_tree(store, &p).map_err(|e| (e, exit::GENERAL_ERROR))?)
        }
        None => None,
    };
    let result = diff_trees(store, parent_tree, Some(tree))
        .map_err(|e| (format!("diff: {e}"), exit::GENERAL_ERROR))?;
    // `--stat` renders the diffstat instead of the full patch (like
    // `git show --stat`), reusing `diff`'s byte-exact stat renderer;
    // `render_stat` hoists its own `DisplaySource` wrapping (#625).
    if stat {
        return super::diff::render_stat(out, store, result.entries.iter())
            .map_err(|e| (e, exit::GENERAL_ERROR));
    }
    // The patch loop below only ever prints what it renders here — nothing
    // durable is published from this path — so skip the BLAKE3 re-verify
    // on every changed blob (#625).
    let display = DisplaySource::new(store);
    for e in &result.entries {
        super::diff::emit_entry_patch(
            out,
            &display,
            e,
            mkit_core::ops::DEFAULT_CONTEXT_LINES,
            mkit_core::ops::WhitespaceMode::Exact,
        )
        .map_err(|e| (e, exit::GENERAL_ERROR))?;
    }
    Ok(())
}

/// Render an annotated/signed tag header, then the peeled target object.
fn show_tag(
    out: &mut impl Write,
    store: &ObjectStore,
    t: &Tag,
    tag_depth: usize,
    stat: bool,
) -> Result<(), (String, u8)> {
    let _ = writeln!(out, "tag {}", String::from_utf8_lossy(&t.name));
    let _ = writeln!(out, "Tagger: {}", format::short_identity(&t.tagger));
    let _ = writeln!(out, "Date:   {}", format::human_date_utc(t.timestamp));
    let _ = writeln!(out);
    // git prints the tag message un-indented, then a blank line, then the
    // target object.
    let msg = String::from_utf8_lossy(&t.message);
    for line in msg.lines() {
        let _ = writeln!(out, "{line}");
    }
    let _ = writeln!(out);

    if tag_depth + 1 >= MAX_TAG_DEPTH {
        return Err(("tag chain too deep".to_string(), exit::DATAERR));
    }
    show_object(out, store, &t.target, tag_depth + 1, stat)
}

/// Write a commit message indented four spaces per line (blank lines stay
/// blank), matching `mkit log`'s default format.
fn write_indented_message(out: &mut impl Write, message: &[u8]) {
    let text = String::from_utf8_lossy(message);
    for line in text.lines() {
        if line.is_empty() {
            let _ = writeln!(out);
        } else {
            let _ = writeln!(out, "    {line}");
        }
    }
}

use super::error as emit_err;