litany 0.0.11

A git-backed agent harness
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

//! The role **assignment's** optional knobs under follow-the-tip
//! (ARCH §4.3; split from [`super::tests`], which owns the
//! workflow-source seam, to hold the per-file line cap).
//!
//! `effort:` and `priority:` ride the same `providers.yaml` assignment
//! as the model pointer, so bl-403b's ruling carries them for free: an
//! edit to the governing lineage's head reaches a running agent at its
//! next resolution, with no re-fork and no per-agent act. Each test
//! walks the fact the whole way — the config commit, `WorkerConfig`,
//! and the borrowed `Resolved` the step loop actually reads.

use super::tests::Fx;
use super::{ConfigSource, resolve_worker};
use crate::workspace::fixture;

/// A `providers.yaml` whose `worker` row carries one extra `knob` line.
fn providers_with(knob: &str) -> String {
    format!(
        "roles:\n  worker:\n    provider: anthropic\n    model: claude-sonnet-5\n    {knob}\n  \
         compactor:\n    provider: anthropic\n    model: claude-haiku-4-5\n"
    )
}

#[test]
fn the_role_effort_follows_the_tip_to_the_resolved_shape() {
    let (_h, ws) = fixture::workspace();
    fixture::spawn_root(&ws, "20260101-r1");
    let fx = Fx::new();
    let before = resolve_worker(&ws, ConfigSource::Agent("20260101-r1"), &fx.deps()).unwrap();
    assert_eq!(before.effort, None, "the shipped template requests none");
    fixture::amend_config(
        &ws,
        &[("providers.yaml", &providers_with("effort: medium"))],
    );
    let cfg = resolve_worker(&ws, ConfigSource::Agent("20260101-r1"), &fx.deps()).unwrap();
    assert_eq!(cfg.effort, Some(crate::config::Effort::Medium));
    assert_eq!(
        cfg.as_resolved().effort,
        Some(crate::config::Effort::Medium)
    );
}

#[test]
fn the_role_priority_follows_the_tip_to_the_resolved_shape() {
    // §4.3 `priority:` × follow-the-tip: checking the box on the
    // lineage's head moves every following agent onto the provider's
    // priority lane at its next step boundary — that IS the switch, and
    // unchecking it is the same act in reverse.
    let (_h, ws) = fixture::workspace();
    fixture::spawn_root(&ws, "20260101-r1");
    let fx = Fx::new();
    let before = resolve_worker(&ws, ConfigSource::Agent("20260101-r1"), &fx.deps()).unwrap();
    assert_eq!(before.priority, None, "the shipped template asks no lane");
    fixture::amend_config(
        &ws,
        &[("providers.yaml", &providers_with("priority: true"))],
    );
    let cfg = resolve_worker(&ws, ConfigSource::Agent("20260101-r1"), &fx.deps()).unwrap();
    assert_eq!(cfg.priority, Some(true));
    assert_eq!(cfg.as_resolved().priority, Some(true));
    // And back off the lane, on the same one act.
    fixture::amend_config(
        &ws,
        &[("providers.yaml", &providers_with("priority: false"))],
    );
    let after = resolve_worker(&ws, ConfigSource::Agent("20260101-r1"), &fx.deps()).unwrap();
    assert_eq!(after.priority, Some(false));
}

#[test]
fn the_role_output_cap_follows_the_tip_to_the_resolved_shape() {
    // §4.3 `max_output_tokens:` × follow-the-tip (bl-a928): the one
    // number of the three token limits an operator could not state.
    // Shipped absent — the harness default governs — and set on the
    // lineage's head it reaches a running agent at its next boundary.
    let (_h, ws) = fixture::workspace();
    fixture::spawn_root(&ws, "20260101-r1");
    let fx = Fx::new();
    let before = resolve_worker(&ws, ConfigSource::Agent("20260101-r1"), &fx.deps()).unwrap();
    assert_eq!(
        before.max_output_tokens, None,
        "the shipped template states no ceiling"
    );
    fixture::amend_config(
        &ws,
        &[(
            "providers.yaml",
            &providers_with("max_output_tokens: 32000"),
        )],
    );
    let cfg = resolve_worker(&ws, ConfigSource::Agent("20260101-r1"), &fx.deps()).unwrap();
    assert_eq!(cfg.max_output_tokens, Some(32000));
    assert_eq!(cfg.as_resolved().max_output_tokens, Some(32000));
}