Function generate_skill_bundle

build.rs:364–409

Generates `$OUT_DIR/plugin_bundle_generated.rs`: a recursive manifest of every file under `plugin/skills/` (SKILL.md *and* any `references/`, `scripts/`, `assets/` support files), embedded via `include_str!` at compile time. Moving embedding off a hand-maintained flat list lets skills ship support files without a matching table edit; the coverage tests assert the generated set equals the on-disk t

()

/// generated slice serves Claude, Codex, and Cursor (Cursor filters out the
/// `tracedecay-*` dispatcher skills at compose time).
fn generate_skill_bundle() {
    let manifest_dir = std::env::var("CARGO_MANIFEST_DIR").expect("CARGO_MANIFEST_DIR");
    let skills_root = Path::new(&manifest_dir).join("plugin/skills");
    println!("cargo::rerun-if-changed=plugin/skills");

    let mut code = String::new();
    code.push_str(
        "// @generated by build.rs (generate_skill_bundle). Do not edit.\n\
         /// Every file under `plugin/skills/` (SKILL.md + support files), embedded\n\
         /// recursively at compile time. `relative` is the deploy path (identical to\n\
         /// the `plugin/`-relative source path).\n\
         pub const GENERATED_SKILL_FILES: &[PluginFile] = &[\n",
    );
    for relative in collect_files_relative(&skills_root) {
        // rerun on each individual file so edits re-trigger codegen even if the
        // directory mtime does not change.
        println!("cargo::rerun-if-changed=plugin/skills/{relative}");
        // Every embedded file goes through `include_str!`, which only accepts
        // UTF-8. A binary support file (e.g. `assets/*.png`) would otherwise
        // fail to compile with an opaque "stream did not contain valid UTF-8"
        // error pointing at the generated file, not the offending asset. Guard
        // it here with a clear message; binary support files are not embeddable
        // yet (add `include_bytes!` handling when that becomes a requirement).
        let abs = skills_root.join(&relative);
        if !is_probably_utf8_text(&abs) {
            panic!(
                "plugin/skills/{relative} is not a UTF-8 text file. The skill bundle codegen \
                 embeds every file via include_str!, so binary support files (e.g. images) are \
                 not embeddable yet. Remove the binary file or add include_bytes! support to \
                 build.rs (generate_skill_bundle)."
            );
        }
        let deploy = format!("skills/{relative}");
        let source = format!("skills/{relative}");
        code.push_str(&format!(
            "    PluginFile {{ relative: {deploy:?}, contents: include_str!(concat!(env!(\"CARGO_MANIFEST_DIR\"), \"/plugin/{source}\")) }},\n"
        ));
    }
    code.push_str("];\n");

    let out_dir = std::env::var("OUT_DIR").expect("OUT_DIR");
    let out_path = Path::new(&out_dir).join("plugin_bundle_generated.rs");
    if let Err(e) = fs::write(&out_path, code) {
        panic!("failed to write {}: {e}", out_path.display());
    }
}

fn main() {
    generate_skill_bundle();