spm-cli 0.3.0

Skill package manager — declare AI skills in ai.json, materialize them for Claude/Copilot without polluting your repo.
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

//! JSON Schema validation for `ai.json`. The schema is the single source of
//! truth for the manifest's shape; it's embedded in the binary and also usable
//! by editors via a `$schema` reference.

use anyhow::{anyhow, bail, Context, Result};
use serde_json::Value;

/// The canonical `ai.json` schema, compiled into the binary.
pub const SOURCE: &str = include_str!("../schema/ai.schema.json");

/// Validate a parsed `ai.json` document against the embedded schema, collecting
/// every violation into one readable error.
pub fn validate(instance: &Value) -> Result<()> {
    let schema: Value =
        serde_json::from_str(SOURCE).context("embedded ai.json schema is not valid JSON")?;
    // The compile/validate error types borrow `schema`, so render them to owned
    // strings before propagating (anyhow errors must be 'static).
    let compiled = jsonschema::JSONSchema::compile(&schema)
        .map_err(|e| anyhow!("embedded ai.json schema is invalid: {e}"))?;

    if let Err(errors) = compiled.validate(instance) {
        let details: Vec<String> = errors
            .map(|e| {
                let at = e.instance_path.to_string();
                let at = if at.is_empty() { "(root)".into() } else { at };
                format!("  at {at}: {e}")
            })
            .collect();
        bail!("ai.json does not match schema:\n{}", details.join("\n"));
    }
    Ok(())
}