agent-policy 0.6.0

Schema-first generator for coding-agent repo policies and compatibility files.
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

//! Renderer for `AGENTS.md`.

use camino::Utf8PathBuf;
use minijinja::Environment;

use crate::{
    error::{Error, Result},
    model::normalized::Policy,
    render::RenderedOutput,
};

const TEMPLATE: &str = include_str!("../../templates/AGENTS.md.j2");

/// Render the `AGENTS.md` output for the given policy.
///
/// # Errors
///
/// Returns [`Error::Render`] if the template fails to compile or render.
pub fn render(policy: &Policy) -> Result<RenderedOutput> {
    let mut env = Environment::new();
    env.add_template("AGENTS.md", TEMPLATE)
        .map_err(|e| Error::Render {
            target: "AGENTS.md".to_owned(),
            source: e,
        })?;

    let tmpl = env.get_template("AGENTS.md").map_err(|e| Error::Render {
        target: "AGENTS.md".to_owned(),
        source: e,
    })?;

    let commands_defined = !policy.commands.is_empty();
    let content = tmpl
        .render(minijinja::context! {
            project => &policy.project,
            commands => &policy.commands,
            commands_defined => commands_defined,
            paths => &policy.paths,
            roles => &policy.roles,
            constraints => &policy.constraints,
        })
        .map_err(|e| Error::Render {
            target: "AGENTS.md".to_owned(),
            source: e,
        })?;

    Ok(RenderedOutput {
        path: Utf8PathBuf::from("AGENTS.md"),
        content,
    })
}