gn-cli 0.1.11

git-notes CLI — add, list, show, sync, resolve notes
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use anyhow::Result;
use clap::Args;
use gn_core::{DataValidator, Namespace};
use std::env;

#[derive(Args, Debug)]
pub struct ValidateArgs {
    /// Namespace to validate (comments, review, todos, or custom)
    #[arg(short, long)]
    pub namespace: Option<String>,

    /// Fail with exit code 1 if any orphan notes (anchoring to missing commits) are found
    #[arg(long, default_value_t = false)]
    pub strict: bool,

    /// Output results as structured JSON
    #[arg(long, default_value_t = false)]
    pub json: bool,
}

pub fn run(args: &ValidateArgs) -> Result<()> {
    let repo_path = env::current_dir()?;
    let validator = DataValidator::new(&repo_path);

    let namespaces = if let Some(ns_str) = &args.namespace {
        vec![Namespace::from_str(ns_str)]
    } else {
        vec![
            Namespace::Comments,
            Namespace::Review,
            Namespace::Todos,
        ]
    };

    let report = validator.validate_all(&namespaces)?;

    if args.json {
        println!("{}", serde_json::to_string_pretty(&report)?);
        if !report.healthy || (args.strict && report.total_orphans > 0) {
            std::process::exit(1);
        }
        return Ok(());
    }

    println!("\x1b[1;36m═══════════════════════════════════════════════════════════════════════\x1b[0m");
    println!("\x1b[1;36m           git-notes Data & Refspec Integrity Validator (fsck)          \x1b[0m");
    println!("\x1b[1;36m═══════════════════════════════════════════════════════════════════════\x1b[0m");
    println!("Repository: \x1b[1m{}\x1b[0m\n", report.repo_root);

    for ref_rep in &report.ref_reports {
        if !ref_rep.exists {
            println!("  \x1b[90m○ {:<24} (ref not yet created / 0 notes)\x1b[0m", ref_rep.ref_path);
            continue;
        }

        let status_badge = if ref_rep.corrupt_blobs == 0 && ref_rep.unparseable_notes == 0 {
            if ref_rep.orphan_notes == 0 {
                "\x1b[32m✔ OK\x1b[0m"
            } else {
                "\x1b[33m⚠ ORPHANS\x1b[0m"
            }
        } else {
            "\x1b[31m✗ CORRUPT\x1b[0m"
        };

        println!(
            "  [{}] \x1b[1m{:<24}\x1b[0m (commit: \x1b[90m{}\x1b[0m | {} note{})",
            status_badge,
            ref_rep.ref_path,
            ref_rep.commit_sha.as_deref().unwrap_or("none").chars().take(8).collect::<String>(),
            ref_rep.note_count,
            if ref_rep.note_count == 1 { "" } else { "s" }
        );

        for issue in &ref_rep.issues {
            if issue.contains("unreachable") || issue.contains("missing commit") {
                println!("      \x1b[33m⚠ {}\x1b[0m", issue);
            } else {
                println!("      \x1b[31m✗ {}\x1b[0m", issue);
            }
        }
    }

    println!("\n\x1b[1;36m───────────────────────────────────────────────────────────────────────\x1b[0m");
    println!(
        "Summary: {} note(s) scanned across {} ref(s). Corrupt: {}, Orphans: {}",
        report.total_notes,
        report.total_refs,
        report.total_corrupt,
        report.total_orphans
    );

    if !report.healthy {
        println!("\x1b[1;31m✗ Data corruption detected in git note references!\x1b[0m");
        anyhow::bail!("Data validation failed: {} corrupt blob(s) detected.", report.total_corrupt);
    } else if report.total_orphans > 0 {
        println!("\x1b[33m💡 Tip: Run 'gn heal' to automatically re-anchor orphan notes after rebases.\x1b[0m");
        if args.strict {
            anyhow::bail!("Strict mode: {} orphan note(s) found.", report.total_orphans);
        }
    } else {
        println!("\x1b[1;32m✔ All git-notes refs and JSON schemas are 100% valid and verified.\x1b[0m");
    }

    Ok(())
}