mars-agents 0.4.8-rc.2

Agent package manager for .agents/ directories
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

/// `.agents` target adapter — deprecated full-fidelity legacy output.
///
/// This is the primary target that Meridian reads at runtime. It emits:
/// - `agents/<name>.md` — full-fidelity agent markdown with frontmatter preserved
/// - `skills/<name>/` — portable skill trees also consumed by external harnesses
///
/// See `design/spec/agents-target-adapter.md` for the V0 contract. The key
/// point: NO field stripping — all agent frontmatter fields needed by Meridian
/// are preserved.
use crate::lock::ItemKind;
use crate::types::DestPath;

use super::TargetAdapter;

#[derive(Debug)]
pub struct AgentsAdapter;

impl TargetAdapter for AgentsAdapter {
    fn name(&self) -> &str {
        ".agents"
    }

    fn skill_variant_key(&self) -> Option<&str> {
        None
    }

    fn default_dest_path(&self, kind: ItemKind, name: &str) -> Option<DestPath> {
        let path = match kind {
            ItemKind::Agent => format!("agents/{name}.md"),
            ItemKind::Skill => format!("skills/{name}"),
            ItemKind::Hook => format!("hooks/{name}"),
            ItemKind::McpServer => format!("mcp/{name}"),
            ItemKind::BootstrapDoc => format!("bootstrap/{name}/BOOTSTRAP.md"),
        };
        Some(DestPath::from(path.as_str()))
    }
}