yardlet 0.8.0

Yardlet: a local AI workbench. Plan, queue, route, validate, and hand off long-running work using your already-installed Codex and Claude Code CLIs as hidden workers.
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

//! Run telemetry: an append-only projection of each run's outcome, used to
//! suggest (never auto-apply) worker-routing policy updates.

use std::io::Write;

use anyhow::Result;
use serde::{Deserialize, Serialize};

use crate::state::Workspace;

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RunTelemetry {
    pub ts: String,
    pub task_id: String,
    /// The intent this run served. Lets the trust report scope to one intent so
    /// a task id reused across intents does not fold its attempts together.
    /// Absent on records written before this field existed (default "").
    #[serde(default, skip_serializing_if = "String::is_empty")]
    pub intent_id: String,
    #[serde(default)]
    pub kind: String,
    #[serde(default)]
    pub risk: String,
    pub worker: String,
    #[serde(default)]
    pub chosen_reason: String,
    #[serde(default)]
    pub result_status: String,
    #[serde(default)]
    pub eval_state: String,
    #[serde(default)]
    pub wall_seconds: u64,
    #[serde(default)]
    pub user_override: Option<String>,
    /// Skills the task declared (for the S4 skill score).
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub skills: Vec<String>,
    /// Structured review verdict, when this run produced one: (passed, total).
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub verdict_pass: Option<(usize, usize)>,
}

pub fn log_path(ws: &Workspace) -> std::path::PathBuf {
    ws.agents_dir().join("telemetry").join("runs.jsonl")
}

/// Append one run record. Failures are non-fatal to a run (telemetry is best
/// effort), so callers ignore the error.
pub fn append_run(ws: &Workspace, rec: &RunTelemetry) -> Result<()> {
    let path = log_path(ws);
    if let Some(parent) = path.parent() {
        std::fs::create_dir_all(parent)?;
    }
    let line = format!("{}\n", serde_json::to_string(rec)?);
    let mut f = std::fs::OpenOptions::new()
        .create(true)
        .append(true)
        .open(&path)?;
    f.write_all(line.as_bytes())?;
    Ok(())
}

/// Read all run records (skips malformed lines).
pub fn read_runs(ws: &Workspace) -> Vec<RunTelemetry> {
    let Ok(text) = std::fs::read_to_string(log_path(ws)) else {
        return Vec::new();
    };
    text.lines()
        .filter(|l| !l.trim().is_empty())
        .filter_map(|l| serde_json::from_str(l).ok())
        .collect()
}