mockforge_core/ai_studio/

config.rs

//! Configuration for AI Studio
//!
//! This module defines configuration structures for the AI Studio, including
//! deterministic mode settings, budget controls, and feature toggles.

use serde::{Deserialize, Serialize};

/// AI mode for workspace
///
/// Controls how AI-generated artifacts are used at runtime.
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
#[serde(rename_all = "snake_case")]
#[derive(Default)]
pub enum AiMode {
    /// Generate once and freeze - AI is only used to produce config/templates.
    /// Runtime mocks use frozen artifacts (no LLM calls).
    GenerateOnceFreeze,

    /// Live mode - AI is used dynamically at runtime for each request.
    #[default]
    Live,
}

/// AI Studio configuration
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
pub struct AiStudioConfig {
    /// Deterministic mode configuration
    #[serde(default)]
    pub deterministic_mode: DeterministicModeConfig,

    /// Budget and cost controls
    #[serde(default)]
    pub budgets: BudgetConfig,

    /// Feature toggles
    #[serde(default)]
    pub features: FeatureConfig,
}

/// Freeze mode for deterministic artifacts
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
#[serde(rename_all = "snake_case")]
#[derive(Default)]
pub enum FreezeMode {
    /// Auto-freeze: Automatically freeze artifacts after generation
    Auto,
    /// Manual freeze: Require explicit user action to freeze artifacts
    #[default]
    Manual,
}

/// Deterministic mode configuration
///
/// When enabled, AI-generated artifacts are frozen to deterministic YAML/JSON files
/// for version control and reproducible testing. Supports both auto and manual freeze modes.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
pub struct DeterministicModeConfig {
    /// Whether deterministic mode is enabled
    #[serde(default = "default_false")]
    pub enabled: bool,

    /// Freeze mode: auto (freeze immediately) or manual (require explicit action)
    #[serde(default)]
    pub mode: FreezeMode,

    /// Automatically freeze AI-generated artifacts after creation
    /// (deprecated: use mode instead, but kept for backward compatibility)
    #[serde(default = "default_true")]
    pub auto_freeze: bool,

    /// Format for frozen artifacts (yaml or json)
    #[serde(default = "default_freeze_format")]
    pub freeze_format: String,

    /// Directory to store frozen artifacts
    #[serde(default = "default_freeze_directory")]
    pub freeze_directory: String,

    /// Whether to track metadata (LLM version, prompt hash, output hash)
    #[serde(default = "default_true")]
    pub track_metadata: bool,
}

impl DeterministicModeConfig {
    /// Check if auto-freeze is enabled (either via mode or legacy auto_freeze flag)
    pub fn is_auto_freeze_enabled(&self) -> bool {
        self.mode == FreezeMode::Auto || self.auto_freeze
    }
}

impl Default for DeterministicModeConfig {
    fn default() -> Self {
        Self {
            enabled: false,
            mode: FreezeMode::Manual,
            auto_freeze: true, // Legacy support
            freeze_format: "yaml".to_string(),
            freeze_directory: ".mockforge/frozen".to_string(),
            track_metadata: true,
        }
    }
}

/// Budget configuration for AI usage
#[derive(Debug, Clone, Serialize, Deserialize)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
pub struct BudgetConfig {
    /// Maximum tokens per workspace
    #[serde(default = "default_max_tokens")]
    pub max_tokens_per_workspace: u64,

    /// Maximum AI calls per day
    #[serde(default = "default_max_calls")]
    pub max_ai_calls_per_day: u64,

    /// Rate limit per minute
    #[serde(default = "default_rate_limit")]
    pub rate_limit_per_minute: u64,

    /// Budget alerts threshold (percentage)
    #[serde(default = "default_alert_threshold")]
    pub alert_threshold: f64,
}

impl Default for BudgetConfig {
    fn default() -> Self {
        Self {
            max_tokens_per_workspace: 100_000,
            max_ai_calls_per_day: 1_000,
            rate_limit_per_minute: 10,
            alert_threshold: 0.8, // Alert at 80% usage
        }
    }
}

/// Feature configuration for enabling/disabling specific AI features
#[derive(Debug, Clone, Serialize, Deserialize)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
pub struct FeatureConfig {
    /// Enable mock generation from natural language
    #[serde(default = "default_true")]
    pub mock_generation: bool,

    /// Enable AI contract diff analysis
    #[serde(default = "default_true")]
    pub contract_diff: bool,

    /// Enable persona generation
    #[serde(default = "default_true")]
    pub persona_generation: bool,

    /// Enable free-form generation (general chat)
    #[serde(default = "default_true")]
    pub free_form_generation: bool,

    /// Enable AI-guided debugging
    #[serde(default = "default_true")]
    pub debug_analysis: bool,
}

impl Default for FeatureConfig {
    fn default() -> Self {
        Self {
            mock_generation: true,
            contract_diff: true,
            persona_generation: true,
            free_form_generation: true,
            debug_analysis: true,
        }
    }
}

// Helper functions for default values

fn default_false() -> bool {
    false
}

fn default_true() -> bool {
    true
}

fn default_freeze_format() -> String {
    "yaml".to_string()
}

fn default_freeze_directory() -> String {
    ".mockforge/frozen".to_string()
}

fn default_max_tokens() -> u64 {
    100_000
}

fn default_max_calls() -> u64 {
    1_000
}

fn default_rate_limit() -> u64 {
    10
}

fn default_alert_threshold() -> f64 {
    0.8
}