difflore-cli 0.1.0

Your AI coding agent, taught by your team's PR reviews — a local-first, open-source MCP server that turns past review comments into rules your agent follows automatically.
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
107
108
109
110
111
112
113
114
115
116
117

//! Integration-flavoured tests across the module boundary. Cover guard logic
//! without spawning `difflore import-reviews`.

use std::path::PathBuf;

use super::guards::{GuardSignals, run_guards_with};
use super::opts::{DEFAULT_MAX_PRS, PostInstallScanOpts};
use super::outcome::{PostInstallScanOutcome, SkipReason};

fn pristine_signals() -> GuardSignals {
    GuardSignals {
        stdin_is_tty: true,
        stdout_is_tty: true,
        gh_on_path: true,
        is_git_repo: true,
        has_github_remote: true,
        in_ci: false,
        explicit_skip: false,
    }
}

#[test]
fn opts_for_cwd_defaults_to_interactive_with_default_max_prs() {
    let opts = PostInstallScanOpts::for_cwd(PathBuf::from("/tmp/repo"));
    assert_eq!(opts.cwd, PathBuf::from("/tmp/repo"));
    assert!(!opts.non_interactive);
    assert_eq!(opts.max_prs, DEFAULT_MAX_PRS);
    assert_eq!(opts.max_prs, 5, "default max_prs documented as 5");
}

#[test]
fn guard_layer_skips_when_stdout_is_piped() {
    let mut s = pristine_signals();
    s.stdout_is_tty = false;
    let outcome = PostInstallScanOutcome::Skipped {
        reason: run_guards_with(s, false).expect_err("non-tty must skip"),
    };
    assert_eq!(
        outcome,
        PostInstallScanOutcome::Skipped {
            reason: SkipReason::NonInteractive,
        }
    );
}

#[test]
fn guard_layer_skips_when_gh_cli_is_missing() {
    let mut s = pristine_signals();
    s.gh_on_path = false;
    let outcome = PostInstallScanOutcome::Skipped {
        reason: run_guards_with(s, false).expect_err("missing gh must skip"),
    };
    assert_eq!(
        outcome,
        PostInstallScanOutcome::Skipped {
            reason: SkipReason::GhNotInstalled,
        }
    );
}

#[test]
fn guard_layer_skips_when_running_in_ci() {
    let mut s = pristine_signals();
    s.in_ci = true;
    let outcome = PostInstallScanOutcome::Skipped {
        reason: run_guards_with(s, false).expect_err("CI must skip"),
    };
    assert_eq!(
        outcome,
        PostInstallScanOutcome::Skipped {
            reason: SkipReason::RunningInCi,
        }
    );
}

#[test]
fn guard_skip_priority_matches_blame_order() {
    // Documents the deliberate priority: explicit user opt-out wins
    // over CI detection, which wins over non-tty, etc. Future
    // maintainers reordering the guards will break this and have to
    // re-read the priority intent.
    let mut s = pristine_signals();
    s.explicit_skip = true;
    s.in_ci = true;
    s.stdin_is_tty = false;
    s.is_git_repo = false;
    s.has_github_remote = false;
    s.gh_on_path = false;
    assert_eq!(
        run_guards_with(s, true),
        Err(SkipReason::ExplicitlySkipped)
    );
}

#[test]
fn outcome_user_engaged_only_true_when_import_actually_ran() {
    assert!(!PostInstallScanOutcome::Declined.user_engaged());
    assert!(
        !PostInstallScanOutcome::Skipped {
            reason: SkipReason::NonInteractive,
        }
        .user_engaged()
    );
    assert!(
        PostInstallScanOutcome::ImportedReviews {
            pr_count: 5,
            rule_count: 3,
        }
        .user_engaged()
    );
    assert!(
        PostInstallScanOutcome::ImportFailed {
            error: "boom".into(),
        }
        .user_engaged()
    );
}