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

//! `agent-policy generate` — load, normalize, render, and write output files.

use camino::Utf8Path;

use crate::{
    error::{Error, Result},
    load,
    model::{normalize, targets::TargetId},
    render,
    util::fs::write_atomic,
};

/// Run the `generate` command.
///
/// Loads and validates `agent-policy.yaml` at `config`, normalizes the model,
/// renders all enabled outputs, and writes them to disk.
///
/// # Errors
///
/// Returns an [`crate::Error`] if any step of the pipeline fails.
pub fn run(config: &Utf8Path, targets: Option<&[String]>) -> Result<()> {
    let raw = load::load_file(config)?;
    let (mut policy, warnings) = normalize(raw)?;

    for w in &warnings {
        eprintln!("warning: {w}");
    }

    if let Some(target_strs) = targets {
        let mut explicit_targets = Vec::new();
        for t in target_strs {
            let id = TargetId::from_id(t).ok_or_else(|| Error::UnknownTarget { id: t.clone() })?;
            explicit_targets.push(id);
        }
        policy.outputs = crate::model::targets::OutputTargets::from_targets(&explicit_targets);
    }

    let outputs = render::render_all(&policy)?;

    let base_dir = config.parent().unwrap_or(Utf8Path::new(""));

    for output in &outputs {
        let path = base_dir.join(&output.path);
        write_atomic(path.as_std_path(), &output.content)?;
        println!("  wrote  {path}");
    }

    println!("\nGenerated {} file(s).", outputs.len());
    Ok(())
}