kranz 0.2.0

Git-native mission control for governed, validated AI coding-agent work.
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

//! Integration test for the OTLP HTTP export path (`kranz_cli::otel::emit`).
//!
//! Stands up a minimal local HTTP receiver bound to `127.0.0.1:0` (an
//! ephemeral port) that accepts POSTs to `/v1/traces`, then runs
//! `export_spans` against it and asserts at least one non-empty request
//! arrived. Hermetic: no external services, no fixed ports.

use axum::body::Bytes;
use axum::routing::post;
use axum::Router;
use chrono::{TimeZone, Utc};
use kranz_cli::otel::map::{span_id, trace_id, AttrValue, MissionSpan, SpanStatus};
use kranz_cli::otel::{build_exporter, export_spans};
use std::sync::atomic::{AtomicUsize, Ordering};
use std::sync::{Arc, Mutex};

#[derive(Clone, Default)]
struct Received {
    count: Arc<AtomicUsize>,
    non_empty: Arc<AtomicUsize>,
    bodies: Arc<Mutex<Vec<Vec<u8>>>>,
}

async fn handle_traces(
    axum::extract::State(state): axum::extract::State<Received>,
    body: Bytes,
) -> &'static str {
    state.count.fetch_add(1, Ordering::SeqCst);
    if !body.is_empty() {
        state.non_empty.fetch_add(1, Ordering::SeqCst);
    }
    state.bodies.lock().unwrap().push(body.to_vec());
    "ok"
}

fn sample_spans() -> Vec<MissionSpan> {
    let ts = |secs: i64| Utc.timestamp_opt(1_700_000_000 + secs, 0).unwrap();
    vec![MissionSpan {
        trace_id: trace_id("m-otel-export"),
        span_id: span_id("m-otel-export", 1),
        parent_span_id: None,
        name: "mission m-otel-export".to_string(),
        start: ts(0),
        end: ts(10),
        attributes: vec![(
            "kranz.mission.status".to_string(),
            AttrValue::String("complete".to_string()),
        )],
        status: SpanStatus::Ok,
    }]
}

#[tokio::test]
async fn from_start_exports_spans_to_endpoint() {
    let received = Received::default();
    let app = Router::new()
        .route("/v1/traces", post(handle_traces))
        .with_state(received.clone());

    let listener = tokio::net::TcpListener::bind("127.0.0.1:0").await.unwrap();
    let addr = listener.local_addr().unwrap();
    tokio::spawn(async move {
        axum::serve(listener, app).await.unwrap();
    });

    let endpoint = format!("http://{addr}/v1/traces");
    let exporter =
        build_exporter(&endpoint).expect("exporter should build against a valid http endpoint");

    export_spans(&exporter, sample_spans()).await;

    // Give the async HTTP client a moment to complete the request.
    tokio::time::sleep(std::time::Duration::from_millis(200)).await;

    assert!(
        received.count.load(Ordering::SeqCst) >= 1,
        "expected at least one export request to reach the mock receiver"
    );
    assert!(
        received.non_empty.load(Ordering::SeqCst) >= 1,
        "expected at least one export request with a non-empty body"
    );
    let bodies = received.bodies.lock().unwrap();
    let body = bodies
        .iter()
        .find(|body| !body.is_empty())
        .expect("non-empty body recorded");
    assert!(
        contains_bytes(body, b"service.name") && contains_bytes(body, b"kranz"),
        "OTLP body should carry service.name=kranz resource metadata"
    );
}

fn contains_bytes(haystack: &[u8], needle: &[u8]) -> bool {
    haystack
        .windows(needle.len())
        .any(|window| window == needle)
}