rustcodegraph 1.2.10

Local-first code intelligence graph and CLI for AI agents
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

//! `RUSTCODEGRAPH_WATCH_DEBOUNCE_MS` env override (issue #403).
//!
//! Lets users tune the watcher quiet window from MCP-launched configs without
//! editing the agent's command line -- formatter-on-save chains and large
//! generated outputs benefit from a longer window. Clamped to [100ms, 60s];
//! out-of-range / non-numeric values fall back to the FileWatcher default
//! (2000ms) rather than throwing or silently capping a likely typo.
//!
//! This is the Rust port of `__tests__/mcp-debounce-env.test.ts`.

use rustcodegraph::mcp::engine::{parse_debounce_env, parse_watch_policy_env};

mod parse_debounce_env {
    use super::*;

    #[test]
    fn returns_undefined_for_unset_empty_values() {
        assert_eq!(parse_debounce_env(None), None);
        assert_eq!(parse_debounce_env(Some("")), None);
        assert_eq!(parse_debounce_env(Some("   ")), None);
    }

    #[test]
    fn accepts_integer_values_inside_100_60000() {
        assert_eq!(parse_debounce_env(Some("100")), Some(100));
        assert_eq!(parse_debounce_env(Some("2000")), Some(2000));
        assert_eq!(parse_debounce_env(Some("5000")), Some(5000));
        assert_eq!(parse_debounce_env(Some("60000")), Some(60000));
    }

    #[test]
    fn rejects_out_of_range_values_returns_undefined_lets_default_win() {
        assert_eq!(parse_debounce_env(Some("0")), None);
        assert_eq!(parse_debounce_env(Some("50")), None); // below 100
        assert_eq!(parse_debounce_env(Some("99")), None);
        assert_eq!(parse_debounce_env(Some("60001")), None); // above 60s
        assert_eq!(parse_debounce_env(Some("-500")), None);
    }

    #[test]
    fn rejects_non_integer_non_numeric_values() {
        assert_eq!(parse_debounce_env(Some("abc")), None);
        assert_eq!(parse_debounce_env(Some("500.5")), None);
        assert_eq!(parse_debounce_env(Some("NaN")), None);
        assert_eq!(parse_debounce_env(Some("Infinity")), None);
    }

    #[test]
    fn accepts_scientific_notation_that_resolves_to_an_in_range_integer() {
        // Number('1e3') === 1000, Number.isInteger(1000) === true. Power users
        // who write debounce as 1e3 should not be surprised; the clamp still applies.
        assert_eq!(parse_debounce_env(Some("1e3")), Some(1000));
    }
}

mod parse_watch_policy_env {
    use super::*;

    #[test]
    fn returns_empty_options_for_unset_empty_values() {
        let options = parse_watch_policy_env(None, Some(""), Some("   "));

        assert_eq!(options.debounce_ms, None);
        assert_eq!(options.max_debounce_ms, None);
        assert_eq!(options.min_sync_interval_ms, None);
    }

    #[test]
    fn accepts_one_minute_batch_policy_values() {
        let options = parse_watch_policy_env(Some("60000"), Some("60000"), Some("60000"));

        assert_eq!(options.debounce_ms, Some(60_000));
        assert_eq!(options.max_debounce_ms, Some(60_000));
        assert_eq!(options.min_sync_interval_ms, Some(60_000));
    }

    #[test]
    fn rejects_invalid_batch_policy_values_and_lets_defaults_win() {
        let options = parse_watch_policy_env(Some("abc"), Some("-500"), Some("500.5"));

        assert_eq!(options.debounce_ms, None);
        assert_eq!(options.max_debounce_ms, None);
        assert_eq!(options.min_sync_interval_ms, None);
    }

    #[test]
    fn rejects_values_above_one_minute() {
        let options = parse_watch_policy_env(Some("60001"), Some("60001"), Some("60001"));

        assert_eq!(options.debounce_ms, None);
        assert_eq!(options.max_debounce_ms, None);
        assert_eq!(options.min_sync_interval_ms, None);
    }
}