systemprompt-loader 0.73.0

File and module discovery infrastructure for systemprompt.io AI governance — manifests, schemas, and extension loading. Separates I/O from shared models in the MCP governance pipeline.
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

//! Reads, validates, writes and enumerates layered profiles.
//!
//! [`ProfileLoader`] is a thin shim over the manifest's layered loader: a
//! profile is `<profiles_dir>/<env>/profile.yaml` over the optional shared
//! `<profiles_dir>/base.yaml`. Writes go to the overlay only.
//!
//! Copyright (c) systemprompt.io — Business Source License 1.1.
//! See <https://systemprompt.io> for licensing details.

use std::path::Path;
use systemprompt_identifiers::ProfileName;
use systemprompt_manifest::Profile;
use systemprompt_manifest::profile::OVERLAY_PROFILE_FILE;

use crate::error::{ProfileLoadError, ProfileLoadResult};

#[derive(Debug, Clone, Copy)]
pub struct ProfileLoader;

impl ProfileLoader {
    pub fn load_from_path(profile_path: &Path) -> ProfileLoadResult<Profile> {
        Profile::load_from_path(profile_path).map_err(ProfileLoadError::from)
    }

    pub fn load(profiles_dir: &Path, profile_name: &ProfileName) -> ProfileLoadResult<Profile> {
        Profile::load_layered(profiles_dir, profile_name.as_str()).map_err(ProfileLoadError::from)
    }

    pub fn load_from_path_and_validate(profile_path: &Path) -> ProfileLoadResult<Profile> {
        let profile = Self::load_from_path(profile_path)?;
        profile.validate().map_err(ProfileLoadError::from)?;
        Ok(profile)
    }

    pub fn load_and_validate(
        profiles_dir: &Path,
        profile_name: &ProfileName,
    ) -> ProfileLoadResult<Profile> {
        let profile = Self::load(profiles_dir, profile_name)?;
        profile.validate().map_err(ProfileLoadError::from)?;
        Ok(profile)
    }

    pub fn save(profile: &Profile, profiles_dir: &Path) -> ProfileLoadResult<()> {
        let overlay_path = profiles_dir.join(&profile.name).join(OVERLAY_PROFILE_FILE);
        let header = format!(
            "# systemprompt.io Profile: {}\n# Overlay over ../base.yaml: holds only what this \
             environment changes.",
            profile.display_name
        );
        profile
            .save_overlay(&overlay_path, Some(&header))
            .map_err(ProfileLoadError::from)
    }

    #[must_use]
    pub fn list_available(profiles_dir: &Path) -> Vec<String> {
        let entries = match std::fs::read_dir(profiles_dir) {
            Ok(entries) => entries,
            Err(e) => {
                if profiles_dir.exists() {
                    tracing::warn!(
                        error = %e,
                        path = %profiles_dir.display(),
                        "Failed to read profiles directory"
                    );
                }
                return Vec::new();
            },
        };
        let mut names: Vec<String> = entries
            .filter_map(Result::ok)
            .filter(|e| e.path().join(OVERLAY_PROFILE_FILE).is_file())
            .map(|e| e.file_name().to_string_lossy().to_string())
            .collect();
        names.sort();
        names
    }
}