/**
 * Features Configuration Loader
 *
 * Loads and validates the unified features configuration from features.json
 * Supports token optimization, model routing, batch operations, and more.
 *
 * @since 2026-01-25
 */
import type { MemoryRoutingConfig } from "../memory-routing/types.js";
import type { SuitHost, SuitProfile, SuitTemperamentConfig } from "../nucleus/suit-temperament.js";
export type { MemoryRoutingConfig };
export interface TokenOptimizationConfig {
    enabled: boolean;
    max_context_tokens: number;
    prune_after_task: boolean;
    summarize_tool_outputs: boolean;
    context_compression: {
        enabled: boolean;
        threshold_tokens: number;
        compression_ratio: number;
    };
}
export interface TaskRouting {
    model: string;
    max_tokens: number;
    description: string;
}
export interface ModelRoutingConfig {
    enabled: boolean;
    default_model?: string;
    fallback_model?: string;
    task_routing?: {
        file_read?: TaskRouting;
        grep_search?: TaskRouting;
        simple_edit?: TaskRouting;
        bulk_refactor?: TaskRouting;
        architecture_review?: TaskRouting;
        security_audit?: TaskRouting;
        git_operations?: TaskRouting;
        documentation?: TaskRouting;
        code_generation?: TaskRouting;
        debugging?: TaskRouting;
    };
}
export interface BatchOperationsConfig {
    enabled: boolean;
    prefer_sed_for_replacements: boolean;
    parallel_file_updates: boolean;
    max_concurrent_edits: number;
    auto_batch_threshold: number;
}
export interface MultiAgentOrchestrationConfig {
    enabled: boolean;
    coordination_model: "async-multi-agent" | "sync-multi-agent";
    max_concurrent_agents: number;
    task_distribution_strategy: "capability-based" | "load-balanced" | "round-robin";
    conflict_resolution: "expert-priority" | "majority-vote" | "consensus";
    progress_tracking: boolean;
    session_persistence: boolean;
    /** Lead-dev operating model (codex 67–68) — ON when suit is worn */
    lead_dev_mode?: boolean;
    per_suite_test_triage?: boolean;
    phased_plan_threshold?: number;
    auto_consult_major_work?: boolean;
    /** Codex 69 — block new MCP/skill/handler files via PreToolUse (default true) */
    no_new_surface?: boolean;
    /** PreToolUse gate after delegate-deferred (default true when lead_dev_mode) */
    auto_chain_delegations?: boolean;
    /** Hours before unstarted lead-dev plan is archived (default 8) */
    plan_stale_hours?: number;
    /** Hours spawn-plan-stale persists after archival (default 24) */
    plan_archive_marker_hours?: number;
    /** Sibling workspace roots for multi-repo session boot metadata */
    sibling_repos?: Array<string | {
        path: string;
        label?: string;
    }>;
    /** Auto-run 3-agent confer at synthesis checkpoint */
    confer_on_synthesis?: boolean;
    confer?: {
        enabled?: boolean;
        on_synthesis?: boolean;
    };
}
/** 0xRay 4.0 — nucleus SSOT. See docs-site/docs/guides/v3-temperament.md */
export type { SuitHost, SuitProfile, SuitTemperamentConfig };
/** Reflection triggers merged from legacy auto_reflection when synthesis is configured */
export interface SynthesisReflectionConfig {
    mode?: AutoReflectionConfig['mode'];
    triggers?: AutoReflectionConfig['triggers'];
    thresholds?: AutoReflectionConfig['thresholds'];
}
/** Periodic reflect & realign checkpoint (Synthesis) */
export interface SynthesisConfig {
    enabled: boolean;
    every_n_gates: number;
    every_n_turns: number;
    every_n_todos_completed: number;
    /** SSOT for reflection triggers when synthesis enabled; seeded from auto_reflection */
    reflection?: SynthesisReflectionConfig;
}
export interface AutonomousReportingConfig {
    enabled: boolean;
    interval_minutes: number;
    auto_schedule: boolean;
    include_health_assessment: boolean;
    include_agent_activities: boolean;
    include_pipeline_operations: boolean;
    include_critical_issues: boolean;
    include_recommendations: boolean;
    report_retention_days: number;
    notification_channels: string[];
}
export interface AgentManagementConfig {
    disabled_agents: string[];
    agent_models: Record<string, string>;
    performance_limits: {
        max_task_duration_ms: number;
        max_memory_usage_mb: number;
        max_tokens_per_request: number;
    };
}
export interface RefactoringConfig {
    enabled: boolean;
    automatic_detection: boolean;
    require_user_approval: boolean;
    max_complexity_threshold: number;
    safe_mode: boolean;
    batch_mode: boolean;
}
export interface ActivityLoggingConfig {
    enabled: boolean;
    level: "debug" | "info" | "warn" | "error";
    include_performance_metrics: boolean;
    include_agent_states: boolean;
    include_token_usage: boolean;
    retention_days: number;
    log_to_file: boolean;
    log_path: string;
}
export interface SecurityConfig {
    enabled: boolean;
    prompt_sanitization: boolean;
    vulnerability_scanning: boolean;
    code_review_enforcement: boolean;
    security_score_threshold: number;
}
export interface PerformanceMonitoringConfig {
    enabled: boolean;
    real_time_metrics: boolean;
    benchmark_tracking: boolean;
    token_tracking: boolean;
    cost_tracking: boolean;
    alerting: {
        enabled: boolean;
        performance_degradation_threshold: number;
        error_rate_threshold: number;
        cost_threshold_daily: number;
    };
}
export interface CachingConfig {
    enabled: boolean;
    file_content_cache: boolean;
    search_result_cache: boolean;
    cache_ttl_seconds: number;
    max_cache_size_mb: number;
}
export interface PublishConfig {
    enabled: boolean;
    require_documentation: {
        enabled: boolean;
        required_files: string[];
        readme_version_sync: boolean;
    };
    require_reflection: {
        enabled: boolean;
        max_age_days: number;
        auto_create_on_publish: boolean;
    };
    require_pipeline_tests: {
        enabled: boolean;
        min_pipeline_tests: number;
    };
}
export interface CommitCycleConfig {
    enabled: boolean;
    auto_commit: {
        enabled: boolean;
        force_commit_after_minutes: number;
        min_changes_to_commit: number;
    };
    require_reflection: {
        enabled: boolean;
        max_commits_since_reflection: number;
        auto_remind: boolean;
    };
    validation: {
        block_on_lint_errors: boolean;
        block_on_test_failures: boolean;
        auto_fix_on_commit: boolean;
    };
}
export interface ReflectionConfig {
    enabled: boolean;
    auto_generate: boolean;
    include_patterns: string[];
    min_quality_score: number;
    store_inference_data: boolean;
}
export interface AutoReflectionConfig {
    mode: "full" | "minimal" | "off";
    description: string;
    triggers: {
        ci_failure: {
            enabled: boolean;
            auto_generate_stub: boolean;
        };
        commit_threshold: {
            enabled: boolean;
            threshold: number;
            auto_generate_stub: boolean;
        };
        time_threshold: {
            enabled: boolean;
            days: number;
            auto_generate_stub: boolean;
        };
        test_failure: {
            enabled: boolean;
            auto_generate_stub: boolean;
        };
        deployment: {
            enabled: boolean;
            auto_generate_stub: boolean;
        };
    };
    thresholds: {
        full: {
            commit_threshold: number;
            days_threshold: number;
            auto_generate: boolean;
            auto_commit: boolean;
            prompt_user: boolean;
        };
        minimal: {
            commit_threshold: number;
            days_threshold: number;
            auto_generate: boolean;
            auto_commit: boolean;
            prompt_user: boolean;
        };
        off: {
            commit_threshold: number;
            days_threshold: number;
            auto_generate: boolean;
            auto_commit: boolean;
            prompt_user: boolean;
        };
    };
}
export interface InferenceConfig {
    description: string;
    enabled: boolean;
    workflow_dir: string;
    reports_dir: string;
    pattern_matching: {
        enabled: boolean;
        confidence_threshold: number;
    };
}
export interface KernelConfig {
    description: string;
    enabled: boolean;
    pattern_learning: {
        enabled: boolean;
        learning_interval_ms: number;
        auto_apply_threshold: number;
        min_success_rate: number;
    };
    confidence: {
        default_threshold: number;
        routing_adjustment: number;
    };
}
export interface ProcessorsConfig {
    description: string;
    enabled: boolean;
    pre_processors: {
        enabled: boolean;
        priority_order: string[];
    };
    post_processors: {
        enabled: boolean;
        priority_order: string[];
    };
}
export interface EnforcementConfig {
    description: string;
    enabled: boolean;
    auto_fix: {
        enabled: boolean;
        require_approval: boolean;
    };
    codex_validation: {
        enabled: boolean;
        strict_mode: boolean;
    };
}
export interface AgentSpawnConfig {
    enabled: boolean;
    max_concurrent: number;
    max_per_type: number;
    spawn_cooldown_ms: number;
    rate_limit_per_minute: number;
}
export interface DelegationConfig {
    enabled: boolean;
    confidence_threshold: number;
    enable_intelligent_routing: boolean;
}
export interface ComplexityThresholds {
    simple: number;
    moderate: number;
    complex: number;
    enterprise: number;
}
export interface AnalyticsConfig {
    enabled: boolean;
    default_limit: number;
    min_samples_for_calibration: number;
    track_complexity_accuracy: boolean;
    track_agent_performance: boolean;
}
export interface PatternLearningConfig {
    enabled: boolean;
    learning_interval_ms: number;
    auto_apply_threshold: number;
    min_success_rate: number;
}
export interface StoryTypeConfig {
    location: string;
    min_words: number;
    ideal_words: number;
    framework: string;
}
export interface StorytellingTriggerConfig {
    enabled: boolean;
    threshold?: number;
    story_type: string;
    remind_user?: boolean;
    file_count_threshold?: number;
    duration_minutes_threshold?: number;
    require_saga?: boolean;
    block_without_story?: boolean;
}
export interface StorytellingQualityRequirements {
    require_frontmatter: boolean;
    require_key_takeaways: boolean;
    require_what_next: boolean;
    fact_check_before_publish: boolean;
    peer_review_agent: string;
}
export interface StorytellingConfig {
    enabled: boolean;
    reflection_triggers: {
        commit_count: StorytellingTriggerConfig;
        publish: StorytellingTriggerConfig;
        complex_changes: StorytellingTriggerConfig;
        session_duration: StorytellingTriggerConfig;
    };
    story_types: {
        reflection: StoryTypeConfig;
        saga: StoryTypeConfig;
        journey: StoryTypeConfig;
        narrative: StoryTypeConfig;
    };
    quality_requirements: StorytellingQualityRequirements;
}
export interface FeaturesConfig {
    version?: string;
    description: string;
    token_optimization: TokenOptimizationConfig;
    model_routing: ModelRoutingConfig;
    batch_operations: BatchOperationsConfig;
    multi_agent_orchestration: MultiAgentOrchestrationConfig;
    autonomous_reporting: AutonomousReportingConfig;
    agent_management: AgentManagementConfig;
    refactoring: RefactoringConfig;
    activity_logging: ActivityLoggingConfig;
    security: SecurityConfig;
    performance_monitoring: PerformanceMonitoringConfig;
    caching: CachingConfig;
    agent_spawn?: AgentSpawnConfig;
    delegation?: DelegationConfig;
    complexity_thresholds?: ComplexityThresholds;
    analytics?: AnalyticsConfig;
    pattern_learning?: PatternLearningConfig;
    publish?: PublishConfig;
    commit_cycle?: CommitCycleConfig;
    reflection?: ReflectionConfig;
    storytelling?: StorytellingConfig;
    auto_reflection?: AutoReflectionConfig;
    inference?: InferenceConfig;
    /** External Dynamo pass. Off uses the local decision matrix. */
    inference_governance?: {
        enabled?: boolean;
    };
    memory_routing?: MemoryRoutingConfig;
    /** Marker is opt-in and the shipped default is off. */
    grok_postprocessor_light?: boolean;
    /** P2 — git post-commit session inference capture */
    inference_session_capture?: {
        enabled?: boolean;
        min_commits?: number;
        lookback_commits?: number;
    };
    synthesis: SynthesisConfig;
    kernel?: KernelConfig;
    processors?: ProcessorsConfig;
    enforcement?: EnforcementConfig;
    /** v3 temperament — missing key means guided (existing consumers unchanged) */
    suit_temperament?: SuitTemperamentConfig;
}
export type TaskType = "file_read" | "grep_search" | "simple_edit" | "bulk_refactor" | "architecture_review" | "security_audit" | "git_operations" | "documentation" | "code_generation" | "debugging" | "unknown";
/**
 * Detect task type from tool name and context
 */
export declare function detectTaskType(toolName: string, context?: {
    fileCount?: number;
    isComplex?: boolean;
}): TaskType;
export declare class FeaturesConfigLoader {
    private featuresPath;
    private cachedConfig;
    private cacheExpiry;
    private lastLoadTime;
    constructor(featuresPath?: string);
    /**
     * Load features configuration
     */
    loadConfig(): FeaturesConfig;
    /**
     * Get model for a specific task type
     */
    getModelForTask(taskType: TaskType): string;
    /**
     * Get max tokens for a specific task type
     */
    getMaxTokensForTask(taskType: TaskType): number;
    /**
     * Check if a feature is enabled
     */
    isFeatureEnabled(feature: keyof FeaturesConfig): boolean;
    /**
     * Get token optimization settings
     */
    getTokenOptimization(): TokenOptimizationConfig;
    /**
     * Get batch operation settings
     */
    getBatchOperations(): BatchOperationsConfig;
    /**
     * Get agent spawn settings
     */
    getAgentSpawn(): AgentSpawnConfig | undefined;
    /**
     * Get activity logging settings
     */
    getActivityLogging(): ActivityLoggingConfig;
    /**
     * Get performance monitoring alerting settings
     */
    getAlertingConfig(): {
        enabled: boolean;
        performance_degradation_threshold: number;
        error_rate_threshold: number;
        cost_threshold_daily: number;
    };
    /**
     * Check if alerting is enabled from config
     */
    isAlertingEnabled(): boolean;
    /**
     * Check if agent is disabled
     */
    isAgentDisabled(agentName: string): boolean;
    /**
     * Get agent model assignment
     */
    getAgentModel(agentName: string): string;
    /**
     * Merge loaded config with defaults
     */
    private mergeWithDefaults;
    /**
     * Get default configuration
     */
    getDefaultConfig(): FeaturesConfig;
    /**
     * Clear configuration cache
     */
    clearCache(): void;
    /**
     * Save current configuration to file
     */
    saveConfig(config: Partial<FeaturesConfig>): void;
    /**
     * Enable a feature
     */
    enableFeature(feature: keyof FeaturesConfig): void;
    /**
     * Disable a feature
     */
    disableFeature(feature: keyof FeaturesConfig): void;
    /**
     * Get XrayConfig-shaped slice for backward compatibility
     * @deprecated Use individual getters or loadConfig() directly instead.
     */
    getXrayConfig(): import("./config-loader.js").XrayConfig;
    getTokenManagement(): FeaturesConfig["token_optimization"] | undefined;
    getProcessors(): ProcessorsConfig | undefined;
    getCommitCycle(): CommitCycleConfig | undefined;
    getStorytelling(): StorytellingConfig | undefined;
    getInference(): InferenceConfig | undefined;
    getMemoryRouting(): MemoryRoutingConfig | undefined;
    getPublish(): PublishConfig | undefined;
    getAutoReporting(): AutonomousReportingConfig | undefined;
    getGovernance(): InferenceConfig | FeaturesConfig["enforcement"] | undefined;
}
export declare const featuresConfigLoader: FeaturesConfigLoader;
export declare const getModelForTask: (taskType: TaskType) => string;
export declare const isFeatureEnabled: (feature: keyof FeaturesConfig) => boolean;
export declare const getTokenOptimization: () => TokenOptimizationConfig;
export declare const getBatchOperations: () => BatchOperationsConfig;
export declare const getAgentSpawn: () => AgentSpawnConfig | undefined;