systemprompt-config

Infrastructure module for environment configuration management, YAML loading, variable resolution, and validation.

Overview

This crate provides configuration management for the SystemPrompt platform:

• YAML Configuration Loading: Loads and merges base and environment-specific YAML files
• Variable Resolution: Resolves ${VAR_NAME} and ${VAR_NAME:-default} patterns
• Secrets Management: Loads .env.secrets files into environment
• Validation: Validates configuration completeness, URL formats, and environment-specific rules
• File Generation: Writes .env files for deployment

File Structure

src/
├── lib.rs                      # Crate root - public API exports
└── services/
    ├── mod.rs                  # Module declarations and re-exports
    ├── manager.rs              # ConfigManager - YAML loading, merging, variable resolution
    ├── schema_validation.rs    # Generic YAML/JSON schema validation utilities
    ├── types.rs                # DeployEnvironment, DeploymentConfig, EnvironmentConfig
    ├── validator.rs            # ConfigValidator, ValidationReport
    └── writer.rs               # ConfigWriter - .env file generation

Modules

manager.rs

Core configuration management functionality:

• ConfigManager::new(project_root) - Initialize with project path
• ConfigManager::generate_config(environment) - Load and merge YAML configs
• Variable resolution with environment variable fallback
• Secrets file loading

schema_validation.rs

Generic schema validation utilities:

• validate_config<T>() - Validate YAML against typed schema
• validate_yaml_file() - Parse and validate YAML syntax
• generate_schema<T>() - Generate JSON schema from types
• build_validate_configs() - Build-time validation for build.rs

types.rs

Configuration type definitions:

• DeployEnvironment - Enum: Local, DockerDev, Production
• DeploymentConfig - Raw YAML configuration container
• EnvironmentConfig - Resolved environment variables

validator.rs

Configuration validation:

• ConfigValidator::validate() - Run all validation checks
• ValidationReport - Collect errors and warnings
• Checks: unresolved variables, required variables, URL formats, port values

writer.rs

Configuration file output:

• ConfigWriter::write_env_file() - Write standard .env file
• ConfigWriter::write_web_env_file() - Write VITE_* variables for web builds

Public API

use systemprompt_config::{
    ConfigManager,
    ConfigValidator,
    DeployEnvironment,
    EnvironmentConfig,
    ValidationReport,
    validate_config,
    validate_yaml_file,
};

Dependencies