borg-web 0.6.0

A local, live page of a collective's knowledge and usage statistics
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

//! `/api/select` serves the collective's lesson selection exactly as borg's monitor reads it (top.rs
//! `Selection`, from the store's selection summary), in process (no port): never recomputed by the
//! page's server, the collective the page picked, and no budget or price unless an engineer set one.

use std::sync::Arc;

use axum::body::Body;
use axum::http::{Request, StatusCode};
use borg::collective::Share;
use borg_web::{App, Mind, router};
use serde_json::{Value, json};
use tower::ServiceExt;

async fn get(app: Arc<App>, url: &str) -> (StatusCode, Value) {
    let res = router(app).oneshot(Request::get(url).header("host", "127.0.0.1:7979").body(Body::empty()).unwrap()).await.unwrap();
    let status = res.status();
    let body = axum::body::to_bytes(res.into_body(), 1 << 20).await.unwrap();
    (status, serde_json::from_slice(&body).unwrap_or(Value::Null))
}

#[tokio::test]
async fn the_selection_is_the_monitors_own_reading_of_the_summary() {
    let root = std::env::temp_dir().join(format!("borg-web-select-{}", std::process::id()));
    let _ = std::fs::remove_dir_all(&root);
    let (corp, mine) = (root.join("corp"), root.join("mine"));
    for home in [&corp, &mine] {
        std::fs::create_dir_all(home).unwrap();
        std::fs::write(home.join("lessons.jsonl"), "").unwrap();
    }
    // Two graded checks of one session, the second asking its 3, a third whose learned decision the
    // fixed rule took over (another check held the decision lock), and a check of the question-count
    // test: what the summary folds.
    let lines = [
        json!({"kind": "graded", "session": "s", "lessons": ["A", "B"], "grades": [2, 1], "applied": 2, "channel": "live", "ms": 1, "repo": "r",
            "policy": "learned", "check": "0123456789ab", "free": ["A", "B"], "pf": [1.0, 1.0]}),
        json!({"kind": "graded", "session": "s", "lessons": ["A"], "grades": [3], "applied": 1, "chosen": ["A"], "p": [1.0], "channel": "stop", "ms": 2,
            "repo": "r", "policy": "learned", "check": "ba9876543210"}),
        json!({"kind": "graded", "session": "s", "lessons": ["C"], "grades": [3], "applied": 1, "chosen": ["C"], "p": [1.0], "channel": "live", "ms": 3,
            "repo": "r", "policy": "fixed", "reason": "lock_busy", "check": "a1b2c3d4e5f6"}),
        // A live check of the question-count test whose draw asked none of its one 2 (k 1, s 0).
        json!({"kind": "graded", "session": "s", "lessons": ["D"], "grades": [2], "applied": 1, "free": ["D"], "p": [0.5], "pf": [0.5], "channel": "live",
            "ms": 4, "repo": "r", "policy": "learned", "source": "experiment", "xk": 1, "xs": 0, "check": "0a1b2c3d4e5f"}),
    ];
    std::fs::write(corp.join("outcomes.jsonl"), lines.iter().map(|l| format!("{l}\n")).collect::<String>()).unwrap();
    let (_tx, stop) = tokio::sync::watch::channel(false);
    let mind = |name: &str, home: &std::path::Path| Mind { name: name.into(), home: home.to_path_buf(), share: Share::Local, mode: "hook" };
    let app = Arc::new(App { minds: vec![mind("corp", &corp), mind("mine", &mine)], first: "mine".into(), cwd: String::new(), stop });

    let (status, v) = get(app.clone(), "/api/select?c=corp").await;
    assert_eq!(status, StatusCode::OK);
    assert_eq!(v["collective"], "corp");
    // The monitor's own reading of corp's summary, under this process's policy: nothing recomputed.
    let lessons = corp.join("lessons.jsonl");
    let want = borg::top::selection(&lessons, borg::select::policy());
    assert_eq!(v["selection"], serde_json::to_value(&want).unwrap(), "{v}");
    let summary = borg::select::summary::load(&lessons);
    assert_eq!((v["selection"]["at"].as_u64(), v["selection"]["fit"].as_str()), (Some(summary.at), Some(summary.fit.key.as_str())));
    assert_eq!(v["selection"]["policy"], borg::select::policy().name());
    // Each reason a learned decision fell back to the fixed rule, of the graded checks folded.
    let rows = json!([
        {"name": "lock_busy", "part": 1, "whole": 4},
        {"name": "lock_failed", "part": 0, "whole": 4},
        {"name": "unrecorded", "part": 0, "whole": 4},
    ]);
    assert_eq!(v["selection"]["fallbacks"], rows, "{v}");
    // The question-count test as the summary folded it, under any policy once it counts a check: one
    // played draw at k 1, s 0, no control, none refused, still in the summary, and the risk share in force.
    let t = &v["selection"]["test"];
    assert_eq!((&t["ran"], &t["control"], &t["refused"], &t["sessions"], &t["kept"]), (&json!(1), &json!(0), &json!(0), &json!(1), &json!(1)), "{v}");
    assert_eq!(t["by_k"], json!([{"k": 1, "draws": [1, 0], "refused": 0}]), "{v}");
    assert_eq!((t["due"].as_bool(), t["risk"].as_f64()), (Some(false), borg::select::risk_of(&lessons).or(Some(borg::select::policy::ALPHA))));
    // No engineer set a budget: spend is measured, never priced.
    assert_eq!(v["selection"]["budget"], Value::Null, "{v}");

    // Without `c`, the collective the page opens with; an unknown one is not found.
    let (status, v) = get(app.clone(), "/api/select").await;
    assert_eq!((status, &v["collective"]), (StatusCode::OK, &json!("mine")));
    assert_eq!(get(app, "/api/select?c=nope").await.0, StatusCode::NOT_FOUND);
    let _ = std::fs::remove_dir_all(&root);
}