bake-agent-context 0.1.1

Install context files from Cargo dependencies for coding agents
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
95
96
97
98
99
100
101
102
103
104

// Released under the MIT License.
// Copyright, 2026, by Samuel Williams.

mod index;
mod installer;

pub use index::AgentIndex;
pub use installer::{ContextFile, ContextPackage, Installer};

use bake::{Context, Error, Result};

fn installer(context: &mut Context) -> Result<Installer> {
    if let Some(installer) = context.get::<Installer>() {
        return Ok(installer.clone());
    }

    let installer = Installer::new(context.root())?;
    context.insert(installer.clone());
    Ok(installer)
}

/// List dependency crates that ship context, or list one crate's context files.
#[bake::task]
pub fn list(context: &mut Context, package: Option<String>) -> Result<String> {
    let installer = installer(context)?;

    if let Some(package) = package {
        let Some(package) = installer.find_package(&package)? else {
            return Ok(format!("No context found for crate '{package}'"));
        };

        let files = installer.list_context_files(&package)?;
        let mut output = format!("Context files for crate '{}':", package.selector());
        for file in files {
            output.push_str(&format!("\n  {}", file.path.display()));
        }
        return Ok(output);
    }

    let packages = installer.packages();
    if packages.is_empty() {
        return Ok("No Cargo dependencies with context found".to_owned());
    }

    let mut output = String::from("Crates with context available:");
    for package in packages {
        output.push_str(&format!("\n  {} ({})", package.selector(), package.version));
    }
    Ok(output)
}

/// Show a context file from one resolved dependency crate.
#[bake::task]
pub fn show(
    context: &mut Context,
    #[bake(named)] package: String,
    #[bake(named)] file: String,
) -> Result<String> {
    let installer = installer(context)?;
    let Some(content) = installer.show_context_file(&package, &file)? else {
        return Err(Error::new(format!(
            "context file {file:?} was not found in crate {package:?}"
        )));
    };
    Ok(content)
}

/// Install one crate's context or all dependency context, then update agents.md.
#[bake::task]
pub fn install(context: &mut Context, package: Option<String>) -> Result<String> {
    let installer = installer(context)?;
    let installed = if let Some(package) = package {
        if installer.install_package(&package)? {
            vec![package]
        } else {
            Vec::new()
        }
    } else {
        installer.install_all()?
    };

    AgentIndex::new(context.root())
        .with_packages(installer.packages())
        .update_agents_md("agents.md")?;

    if installed.is_empty() {
        Ok("No dependency context was installed".to_owned())
    } else {
        Ok(format!("Installed context from: {}", installed.join(", ")))
    }
}

/// Create or update the generated Context section in an agents.md file.
#[bake::task(name = "agents-md")]
pub fn agents_md(
    context: &mut Context,
    #[bake(default = "agents.md")] path: String,
) -> Result<String> {
    let installer = installer(context)?;
    AgentIndex::new(context.root())
        .with_packages(installer.packages())
        .update_agents_md(&path)?;
    Ok(format!("Updated {path}"))
}