yog 0.0.7

yog: the standalone server for litany loops — the world, the balls and the conversations, behind one wire
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

//! The **flat receipts** (§8.5): the replies that carry no rows at all — a
//! kind, and at most a flag or two saying which way a write went. Their own
//! file at §12's cap (bl-94b4), on the seam every sibling here is cut along:
//! everything else in this directory encodes a *list* or a derived sub-object,
//! and these encode a fact about the gesture that just ran.

use super::*;
use crate::opslog::Origin;
use crate::start::Prepared;
use std::path::PathBuf;

#[test]
fn every_flat_receipt_says_what_happened() {
    let started = encode(&Reply::Started {
        conversation: "brave-fox".into(),
    });
    assert_eq!(started["ok"], true);
    assert_eq!(started["conversation"], "brave-fox");
    let deleted = encode(&Reply::Deleted);
    assert_eq!(deleted["kind"], "deleted");
    assert_eq!(deleted["ok"], true);
    assert_eq!(encode(&Reply::Acked)["kind"], "acked");
    // The §8.2 nudge's receipt is the launch and nothing more: what the turn
    // then does lands on the transcript, not here (bl-9bef).
    let nudged = encode(&Reply::Nudged);
    assert_eq!(nudged["kind"], "nudged");
    assert_eq!(nudged["ok"], true);
    assert_eq!(encode(&Reply::TrailCleared)["kind"], "trail-cleared");
    // The VISION §4.9 monitor's two: arming says which way it went, so a seat
    // never has to re-read the config file to know what it just did.
    let armed = encode(&Reply::Armed { armed: true });
    assert_eq!(armed["kind"], "armed");
    assert_eq!(armed["armed"], true);
    assert_eq!(encode(&Reply::Armed { armed: false })["armed"], false);
    assert_eq!(encode(&Reply::Flagged)["kind"], "flagged");
    // The §8.6 answer names the call it landed on — the receipt an audit reads
    // — and says whether the release was actually launched.
    let answered = encode(&Reply::Answered {
        tool_use: "toolu_42".into(),
        tool: "bash".into(),
        ruling: crate::control::judge::Ruling::Pass,
        advanced: true,
    });
    assert_eq!(answered["kind"], "answered");
    assert_eq!(answered["tool_use"], "toolu_42");
    assert_eq!(answered["tool"], "bash");
    assert_eq!(answered["verdict"], "pass");
    assert_eq!(answered["advanced"], true);
    // The §4.9 fifth rung's receipt states what **stands**, not what was asked
    // — so a restore under an ancestor's floor cannot read as a restore.
    let floored = encode(&Reply::Floored { standing: true });
    assert_eq!(floored["kind"], "floored");
    assert_eq!(floored["standing"], true);
    assert_eq!(
        encode(&Reply::Floored { standing: false })["standing"],
        false
    );
}

/// The fan's reply rows **are** `prepared` bodies, so a headless fan is
/// fan-then-N-prompts with nothing reshaped in between; the retirement answers
/// what the policy did, not what was asked.
#[test]
fn the_fan_reply_rows_re_enter_as_prompt_gestures() {
    let prepared = Prepared {
        workspace: crate::naming::leaf(&(PathBuf::from("/ws"))),
        binding: Some(PathBuf::from("/state/balls/attempts/dev/proj/at-0badcafe")),
        goal: "g".into(),
        origin: Origin::Balls,
        lineage: None,
    };
    let v = encode(&Reply::Fanned(vec![prepared.clone()]));
    assert_eq!(v["ok"], true);
    assert_eq!(v["kind"], "fanned");
    let back = serde_json::json!({ "op": "prompt", "prepared": v["rows"][0], "goal": "g2" });
    assert_eq!(
        crate::boundary::codec::decode(&back),
        Ok(crate::boundary::Gesture::Act(
            crate::boundary::Action::Prompt {
                prepared,
                goal: "g2".into(),
                seed: None,
            }
        ))
    );
    for discarded in [false, true] {
        let v = encode(&Reply::Retired { discarded });
        assert_eq!(v["kind"], "retired");
        assert_eq!(v["discarded"], discarded);
        assert_eq!(v["ok"], true);
    }
}

/// The delivery receipt says absence by saying nothing (bl-c2bd): an unmade
/// source ref and a delivery that landed nothing are **absent** fields, never
/// nulls — upstream's own meaning kept on the wire.
#[test]
fn a_delivery_receipt_says_absence_by_saying_nothing() {
    let v = encode(&Reply::Delivered(crate::fan::Delivery {
        target: "work/bl-1".into(),
        base: "aaa1".into(),
        source: None,
        commit: None,
    }));
    assert_eq!(v["kind"], "delivered");
    assert_eq!(v["target"], "work/bl-1");
    assert!(v.get("source").is_none(), "{v}");
    assert!(v.get("commit").is_none(), "{v}");
}