sprawling 0.0.12

A local multi-agent harness for persistent agent teams: long-running project work, agent communication, and experiments in coordination and social simulation.
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

// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at https://mozilla.org/MPL/2.0/.
// Copyright (c) 2026 2youg1 and the sprawling contributors

#![allow(
    clippy::float_arithmetic,
    clippy::unwrap_used,
    clippy::expect_used,
    clippy::panic,
    clippy::indexing_slicing,
    clippy::string_slice,
    clippy::arithmetic_side_effects,
    reason = "test code"
)]

use super::door::*;

/// **The property the whole card exists for.** A minted code has to
/// be the code that opens the door, and the two halves reach that
/// digest by different routes: `PairingToken::mint` hashes the text
/// it just produced, while `serve` hashes the text it is handed back
/// through `from_configured`. If those ever stop agreeing, an
/// exposed city refuses the person who started it, holding a key it
/// minted for them.
#[test]
fn the_key_this_city_mints_is_the_key_its_own_door_accepts() {
    let exposed = "0.0.0.0:8787".parse().expect("a literal address");
    let Keyed::Minted(code) = key_for(exposed, None).expect("this machine has entropy") else {
        panic!("an address beyond this machine with nothing configured mints one");
    };
    let digest = wire::PairingToken::from_configured(&code)
        .expect("a minted code is long enough to adopt")
        .digest();
    assert!(
        wire::verify(Some(&code), &digest),
        "the code shown to a person opens the door it guards"
    );
    assert!(!wire::verify(None, &digest), "silence is not the key");
}

/// One-time means one time. Two serves of the same address must not
/// produce the same code, or a key read off yesterday's terminal
/// still works today.
#[test]
fn two_serves_of_one_address_mint_two_different_keys() {
    let exposed = "0.0.0.0:8787".parse().expect("a literal address");
    let first = key_for(exposed, None).expect("entropy");
    let second = key_for(exposed, None).expect("entropy");
    assert_ne!(first.code(), second.code());
}

/// What the operator configured is adopted, never replaced. Minting
/// over it would break every browser already paired with this city.
#[test]
fn a_configured_token_is_adopted_rather_than_replaced() {
    let exposed = "0.0.0.0:8787".parse().expect("a literal address");
    let configured = "a-token-the-operator-chose".to_owned();
    assert_eq!(
        key_for(exposed, Some(configured.clone())).expect("no entropy is drawn"),
        Keyed::Adopted(configured)
    );
}

/// A loopback listener holds a key too, and nobody is shown it: the
/// loopback port is no credential (wire D54).
#[test]
fn a_loopback_listener_mints_a_key_nobody_is_shown() {
    let local = "127.0.0.1:8787".parse().expect("a literal address");
    let keyed = key_for(local, None).expect("this machine has entropy");
    assert!(matches!(keyed, Keyed::Unshown(_)));
    assert_eq!(keyed.shown(), None);
    assert!(!keyed.code().is_empty());
}