mars-schema 0.28.0

Pure schema reader and editor for Mars agent packages
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

//! Published schema-v1 reader contract fixtures.

use std::{
    fs,
    path::{Path, PathBuf},
};

use mars_schema::diagnostic::PathSegment;

mod common;

/// The package-relative path a read fixture's source file stands for.
fn fixture_path(dir: &Path) -> (&'static str, PathBuf) {
    if dir.join("agent.md").exists() {
        ("agents/agent.md", dir.join("agent.md"))
    } else if dir.join("skill.md").exists() {
        ("skills/skill/SKILL.md", dir.join("skill.md"))
    } else {
        ("mars.toml", dir.join("mars.toml"))
    }
}

#[test]
fn read_fixtures_match() {
    for dir in common::cases("read") {
        let (path, file) = fixture_path(&dir);
        let reading = mars_schema::read::read(path, &fs::read_to_string(file).unwrap()).unwrap();
        common::assert_file(&dir.join("expected.json"), &common::pretty(&reading));
    }
}

#[test]
fn read_refuses_paths_that_are_not_schema_files() {
    for path in [
        "README.md",
        "agents/dir/a.md",
        "agents/.md",
        "skills/a.md",
        "skills/a/b/SKILL.md",
        "skills//SKILL.md",
        "mars.lock",
        "",
    ] {
        assert!(mars_schema::read::read(path, "").is_err(), "{path}");
    }
}

#[test]
fn diagnostic_paths_preserve_authored_keys() {
    let read = mars_schema::agent::read(
        "---\nfuture.key: value\ntools:\n  read(foo.bar): nope\nharness-overrides:\n  claude:\n    a[b]: null\n---\n",
    );
    let paths: Vec<_> = read
        .diagnostics
        .iter()
        .map(|diagnostic| diagnostic.path.clone())
        .collect();
    assert!(paths.contains(&vec![PathSegment::Key("future.key".into())]));
    assert!(paths.contains(&vec![
        PathSegment::Key("tools".into()),
        PathSegment::Key("read(foo.bar)".into()),
    ]));
    assert!(paths.contains(&vec![
        PathSegment::Key("harness-overrides".into()),
        PathSegment::Key("claude".into()),
        PathSegment::Key("a[b]".into()),
    ]));
}

#[test]
fn structural_scan_handles_unicode_and_parser_disagreement() {
    let cjk = mars_schema::agent::read(
        "---\nname: a\ndescription: 汉汉汉汉汉汉汉汉汉汉汉汉汉汉汉汉汉汉汉汉\n---\nbody",
    );
    assert!(cjk.diagnostics.is_empty(), "{:?}", cjk.diagnostics);

    let document_end = mars_schema::agent::read("---\nname: é\n...\n---\nbody");
    assert!(
        document_end
            .diagnostics
            .iter()
            .any(|diagnostic| diagnostic.code == "yaml.document-end")
    );

    let disagreement = mars_schema::agent::read(
        "---\nname: &x a\nmodel: *x\ndescription: \"foo\nbar\"\n---\nbody",
    );
    assert!(
        disagreement
            .diagnostics
            .iter()
            .any(|diagnostic| diagnostic.code == "yaml.anchor")
    );
    assert!(
        disagreement
            .diagnostics
            .iter()
            .any(|diagnostic| diagnostic.code == "yaml.unsupported-syntax")
    );
}