agent-runbook 0.1.1

Generate a local runbook for AI coding agents.
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

use crate::checks::Fact;
use crate::interpret::Message;
use crate::scan::{ScanMode, ScanResult};

pub fn render_scan(result: &ScanResult) -> String {
    let mut lines = Vec::new();

    lines.push("Agent Runbook Scan".to_string());
    lines.push(format!("Mode: {}", result.mode.as_str()));
    lines.push(format!("Project: {}", result.cwd.display()));
    lines.push(String::new());

    if result.mode != ScanMode::Local {
        section(
            &mut lines,
            "Global Tools",
            render_global_tools(&result.summary.global_tools),
        );
    }

    if result.mode != ScanMode::Global {
        section(
            &mut lines,
            "Local Requirements",
            render_local_requirements(&result.summary.local_requirements),
        );
    }

    section(
        &mut lines,
        "Recommended Operating Guardrails",
        render_messages(&result.summary.recommendations),
    );
    section(
        &mut lines,
        "Warnings",
        render_messages(&result.summary.warnings),
    );

    lines.join("\n").trim_end().to_string()
}

fn section(lines: &mut Vec<String>, title: &str, rows: Vec<String>) {
    lines.push(title.to_string());
    if rows.is_empty() {
        lines.push("- None".to_string());
    } else {
        lines.extend(rows);
    }
    lines.push(String::new());
}

fn render_global_tools(tools: &[Fact]) -> Vec<String> {
    tools
        .iter()
        .map(|tool| {
            let version = tool
                .version
                .as_ref()
                .map(|value| format!(" ({value})"))
                .unwrap_or_default();
            format!(
                "- {}: {}{}",
                tool.label,
                tool.command.as_deref().unwrap_or("unknown"),
                version
            )
        })
        .collect()
}

fn render_local_requirements(requirements: &[Fact]) -> Vec<String> {
    requirements
        .iter()
        .map(|requirement| {
            format!(
                "- {}: {}",
                requirement.label,
                requirement
                    .evidence
                    .as_deref()
                    .unwrap_or(&requirement.value)
            )
        })
        .collect()
}

fn render_messages(messages: &[Message]) -> Vec<String> {
    messages
        .iter()
        .map(|message| {
            let evidence = message
                .evidence
                .as_ref()
                .map(|value| format!(" [{value}]"))
                .unwrap_or_default();
            format!("- {}{}", message.text, evidence)
        })
        .collect()
}