forjar 1.4.2

Rust-native Infrastructure as Code — bare-metal first, BLAKE3 state, provenance tracing
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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267

//! Coverage tests for cli/observe.rs — cmd_anomaly, cmd_trace.

fn make_event_converged(machine: &str, resource: &str) -> String {
    format!(
        r#"{{"ts":"2026-01-01T00:00:00Z","event":"resource_converged","machine":"{machine}","resource":"{resource}","duration_seconds":1.5,"hash":"blake3:abc"}}"#
    )
}

fn make_event_failed(machine: &str, resource: &str) -> String {
    format!(
        r#"{{"ts":"2026-01-01T00:01:00Z","event":"resource_failed","machine":"{machine}","resource":"{resource}","error":"exit code 1"}}"#
    )
}

fn make_event_drift(machine: &str, resource: &str) -> String {
    format!(
        r#"{{"ts":"2026-01-01T00:02:00Z","event":"drift_detected","machine":"{machine}","resource":"{resource}","expected":"hash1","actual":"hash2"}}"#
    )
}

fn setup_events(dir: &std::path::Path, machine: &str, events: &[String]) {
    let mdir = dir.join(machine);
    std::fs::create_dir_all(&mdir).unwrap();
    let content = events.join("\n") + "\n";
    std::fs::write(mdir.join("events.jsonl"), content).unwrap();
}

fn make_trace_span(machine: &str, name: &str, clock: u64) -> String {
    format!(
        r#"{{"trace_id":"t001","span_id":"s{clock:03}","parent_span_id":null,"name":"{name}","start_time":"2026-01-01T00:00:00Z","duration_us":1500000,"exit_code":0,"resource_type":"package","action":"converge","content_hash":"abc","logical_clock":{clock},"machine":"{machine}"}}"#
    )
}

fn setup_traces(dir: &std::path::Path, machine: &str, spans: &[String]) {
    let mdir = dir.join(machine);
    std::fs::create_dir_all(&mdir).unwrap();
    let content = spans.join("\n") + "\n";
    std::fs::write(mdir.join("trace.jsonl"), content).unwrap();
}

// ── cmd_anomaly ──

#[test]
fn anomaly_empty_dir() {
    let d = tempfile::tempdir().unwrap();
    let r = super::observe::cmd_anomaly(d.path(), None, 3, false);
    assert!(r.is_ok());
}

#[test]
fn anomaly_empty_dir_json() {
    let d = tempfile::tempdir().unwrap();
    let r = super::observe::cmd_anomaly(d.path(), None, 3, true);
    assert!(r.is_ok());
}

#[test]
fn anomaly_missing_dir() {
    let r = super::observe::cmd_anomaly(std::path::Path::new("/nonexistent/state"), None, 3, false);
    assert!(r.is_err());
}

#[test]
fn anomaly_no_events_file() {
    let d = tempfile::tempdir().unwrap();
    std::fs::create_dir_all(d.path().join("web1")).unwrap();
    let r = super::observe::cmd_anomaly(d.path(), None, 3, false);
    assert!(r.is_ok());
}

#[test]
fn anomaly_with_converged_events() {
    let d = tempfile::tempdir().unwrap();
    let events: Vec<String> = (0..5)
        .map(|i| make_event_converged("web1", &format!("pkg{i}")))
        .collect();
    setup_events(d.path(), "web1", &events);
    let r = super::observe::cmd_anomaly(d.path(), None, 1, false);
    assert!(r.is_ok());
}

#[test]
fn anomaly_with_converged_events_json() {
    let d = tempfile::tempdir().unwrap();
    let events: Vec<String> = (0..5)
        .map(|i| make_event_converged("web1", &format!("pkg{i}")))
        .collect();
    setup_events(d.path(), "web1", &events);
    let r = super::observe::cmd_anomaly(d.path(), None, 1, true);
    assert!(r.is_ok());
}

#[test]
fn anomaly_with_failures() {
    let d = tempfile::tempdir().unwrap();
    let mut events = Vec::new();
    for _ in 0..10 {
        events.push(make_event_failed("web1", "bad-pkg"));
    }
    events.push(make_event_converged("web1", "good-pkg"));
    setup_events(d.path(), "web1", &events);
    let r = super::observe::cmd_anomaly(d.path(), None, 1, false);
    assert!(r.is_ok());
}

#[test]
fn anomaly_with_drift() {
    let d = tempfile::tempdir().unwrap();
    let mut events = Vec::new();
    for _ in 0..10 {
        events.push(make_event_drift("web1", "drifty"));
    }
    events.push(make_event_converged("web1", "stable"));
    setup_events(d.path(), "web1", &events);
    let r = super::observe::cmd_anomaly(d.path(), None, 1, false);
    assert!(r.is_ok());
}

#[test]
fn anomaly_machine_filter() {
    let d = tempfile::tempdir().unwrap();
    setup_events(d.path(), "web1", &[make_event_converged("web1", "nginx")]);
    setup_events(d.path(), "db1", &[make_event_failed("db1", "pg")]);
    let r = super::observe::cmd_anomaly(d.path(), Some("web1"), 1, false);
    assert!(r.is_ok());
}

#[test]
fn anomaly_machine_filter_no_match() {
    let d = tempfile::tempdir().unwrap();
    setup_events(d.path(), "web1", &[make_event_converged("web1", "nginx")]);
    let r = super::observe::cmd_anomaly(d.path(), Some("zzz"), 1, false);
    assert!(r.is_ok());
}

#[test]
fn anomaly_high_min_events() {
    let d = tempfile::tempdir().unwrap();
    setup_events(d.path(), "web1", &[make_event_converged("web1", "nginx")]);
    let r = super::observe::cmd_anomaly(d.path(), None, 100, false);
    assert!(r.is_ok());
}

#[test]
fn anomaly_mixed_events_json() {
    let d = tempfile::tempdir().unwrap();
    let events = vec![
        make_event_converged("web1", "nginx"),
        make_event_failed("web1", "nginx"),
        make_event_drift("web1", "nginx"),
        make_event_converged("web1", "nginx"),
        make_event_failed("web1", "nginx"),
    ];
    setup_events(d.path(), "web1", &events);
    let r = super::observe::cmd_anomaly(d.path(), None, 1, true);
    assert!(r.is_ok());
}

#[test]
fn anomaly_multi_machine() {
    let d = tempfile::tempdir().unwrap();
    setup_events(d.path(), "web1", &[
        make_event_converged("web1", "nginx"),
        make_event_converged("web1", "nginx"),
    ]);
    setup_events(d.path(), "db1", &[
        make_event_failed("db1", "pg"),
        make_event_failed("db1", "pg"),
        make_event_failed("db1", "pg"),
    ]);
    let r = super::observe::cmd_anomaly(d.path(), None, 1, false);
    assert!(r.is_ok());
}

// ── cmd_trace ──

#[test]
fn trace_empty_dir() {
    let d = tempfile::tempdir().unwrap();
    let r = super::observe::cmd_trace(d.path(), None, false);
    assert!(r.is_ok());
}

#[test]
fn trace_empty_dir_json() {
    let d = tempfile::tempdir().unwrap();
    let r = super::observe::cmd_trace(d.path(), None, true);
    assert!(r.is_ok());
}

#[test]
fn trace_missing_dir() {
    let r = super::observe::cmd_trace(std::path::Path::new("/nonexistent/state"), None, false);
    assert!(r.is_err());
}

#[test]
fn trace_no_trace_file() {
    let d = tempfile::tempdir().unwrap();
    std::fs::create_dir_all(d.path().join("web1")).unwrap();
    let r = super::observe::cmd_trace(d.path(), None, false);
    assert!(r.is_ok());
}

#[test]
fn trace_with_spans() {
    let d = tempfile::tempdir().unwrap();
    let spans = vec![
        make_trace_span("web1", "apply:nginx", 1),
        make_trace_span("web1", "apply:config", 2),
    ];
    setup_traces(d.path(), "web1", &spans);
    let r = super::observe::cmd_trace(d.path(), None, false);
    assert!(r.is_ok());
}

#[test]
fn trace_with_spans_json() {
    let d = tempfile::tempdir().unwrap();
    let spans = vec![
        make_trace_span("web1", "apply:nginx", 1),
        make_trace_span("web1", "apply:config", 2),
    ];
    setup_traces(d.path(), "web1", &spans);
    let r = super::observe::cmd_trace(d.path(), None, true);
    assert!(r.is_ok());
}

#[test]
fn trace_machine_filter() {
    let d = tempfile::tempdir().unwrap();
    setup_traces(d.path(), "web1", &[make_trace_span("web1", "apply:nginx", 1)]);
    setup_traces(d.path(), "db1", &[make_trace_span("db1", "apply:pg", 2)]);
    let r = super::observe::cmd_trace(d.path(), Some("web1"), false);
    assert!(r.is_ok());
}

#[test]
fn trace_machine_filter_no_match() {
    let d = tempfile::tempdir().unwrap();
    setup_traces(d.path(), "web1", &[make_trace_span("web1", "apply:nginx", 1)]);
    let r = super::observe::cmd_trace(d.path(), Some("zzz"), false);
    assert!(r.is_ok());
}

#[test]
fn trace_multi_machine() {
    let d = tempfile::tempdir().unwrap();
    setup_traces(d.path(), "web1", &[
        make_trace_span("web1", "apply:nginx", 1),
        make_trace_span("web1", "apply:config", 3),
    ]);
    setup_traces(d.path(), "db1", &[
        make_trace_span("db1", "apply:pg", 2),
    ]);
    let r = super::observe::cmd_trace(d.path(), None, false);
    assert!(r.is_ok());
}

#[test]
fn trace_multi_machine_json() {
    let d = tempfile::tempdir().unwrap();
    setup_traces(d.path(), "web1", &[make_trace_span("web1", "apply:nginx", 1)]);
    setup_traces(d.path(), "db1", &[make_trace_span("db1", "apply:pg", 2)]);
    let r = super::observe::cmd_trace(d.path(), None, true);
    assert!(r.is_ok());
}