xbp_cli/

config.rs

//! configuration management module
//!
//! handles ssh configuration and yaml config file management
//! provides loading and saving of configuration files
//! supports home directory based config storage

use crate::codetime::{
    collect_system_inventory as collect_codetime_system_inventory, SystemInventory,
    SystemInventoryOptions,
};
use crate::dns_inventory_cache::DnsInventoryCache;
use crate::openrouter::{
    DEFAULT_COMMIT_SYSTEM_PROMPT, DEFAULT_MODEL, DEFAULT_RELEASE_NOTES_SYSTEM_PROMPT,
};
use crate::utils::{
    find_xbp_config_upwards, first_lookup_value, load_env_lookup, CLOUDFLARE_ACCOUNT_ID_ENV_KEYS,
};
use chrono::{DateTime, Duration as ChronoDuration, Utc};
use reqwest::Url;
use serde::{Deserialize, Serialize};
use std::collections::BTreeMap;
use std::env;
use std::fs;
use std::path::Path;
use std::path::PathBuf;
use xbp_core::{RunnerExecutionRuntime, RunnerPlatform};

#[derive(Debug, Clone)]
pub struct GlobalXbpPaths {
    pub root_dir: PathBuf,
    pub config_file: PathBuf,
    pub ssh_dir: PathBuf,
    pub cache_dir: PathBuf,
    pub logs_dir: PathBuf,
    pub versioning_files_file: PathBuf,
    pub package_name_files_file: PathBuf,
}

#[derive(Debug, Clone)]
pub struct SystemInventorySyncResult {
    pub inventory: SystemInventory,
    pub config_path: PathBuf,
    pub refreshed: bool,
}

#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq)]
pub struct DeviceIdentity {
    #[serde(default)]
    pub hardware_id: String,
    #[serde(default)]
    pub created_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq)]
pub struct LinearReleaseConfig {
    #[serde(default)]
    pub enabled: Option<bool>,
    #[serde(default)]
    pub initiative_ids: Option<Vec<String>>,
    #[serde(default, alias = "org_name")]
    pub organization_name: Option<String>,
    #[serde(default)]
    pub health: Option<String>,
}

#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq)]
pub struct LinearConfig {
    #[serde(default)]
    pub release: Option<LinearReleaseConfig>,
}

/// Client-side filters for `xbp worktree-watch` (never sent to the server).
///
/// Configured in the global `~/.xbp/config.yaml` (or platform equivalent):
///
/// ```yaml
/// worktree_watch:
///   forbidden_paths:
///     - secrets/
///     - apps/web/.env.local
///   forbidden_folders:
///     - .cache
///     - coverage
///   banned_words:
///     - credential
///     - private-key
/// ```
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq)]
pub struct WorktreeWatchConfig {
    /// Relative path prefixes (repo-root relative). Nested under a watched tree is still blocked.
    /// Examples: `secrets`, `secrets/`, `apps/web/.turbo`, `**/dist` is NOT glob — use folder names.
    #[serde(default, alias = "exclude_paths", alias = "forbidden_path")]
    pub forbidden_paths: Vec<String>,
    /// Directory / path-segment names blocked anywhere in the relative path.
    #[serde(default, alias = "exclude_folders", alias = "forbidden_folder")]
    pub forbidden_folders: Vec<String>,
    /// Case-insensitive substrings; if any appear in the relative path, the path is ignored.
    #[serde(default, alias = "forbidden_words", alias = "banned_word")]
    pub banned_words: Vec<String>,
}

#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq)]
pub struct SecretMetadata {
    #[serde(default)]
    pub added_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq)]
pub struct CliAuthState {
    #[serde(default)]
    pub user_id: Option<String>,
    #[serde(default)]
    pub user_name: Option<String>,
    #[serde(default)]
    pub user_email: Option<String>,
    #[serde(default)]
    pub token_label: Option<String>,
    #[serde(default)]
    pub token_prefix: Option<String>,
    #[serde(default)]
    pub token_created_at: Option<DateTime<Utc>>,
    #[serde(default)]
    pub token_expires_at: Option<DateTime<Utc>>,
    #[serde(default)]
    pub last_verified_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq)]
pub struct CursorIngestState {
    #[serde(default)]
    pub last_status: Option<String>,
    #[serde(default)]
    pub last_trigger: Option<String>,
    #[serde(default)]
    pub last_mode: Option<String>,
    #[serde(default)]
    pub last_attempted_at: Option<DateTime<Utc>>,
    #[serde(default)]
    pub last_succeeded_at: Option<DateTime<Utc>>,
    #[serde(default)]
    pub last_error: Option<String>,
    #[serde(default)]
    pub last_workspace_count: Option<usize>,
    #[serde(default)]
    pub last_entry_count: Option<usize>,
    #[serde(default)]
    pub last_entries_skipped: Option<usize>,
}

#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq)]
pub struct SystemInventoryRefreshState {
    #[serde(default)]
    pub last_status: Option<String>,
    #[serde(default)]
    pub last_trigger: Option<String>,
    #[serde(default)]
    pub last_mode: Option<String>,
    #[serde(default)]
    pub last_attempted_at: Option<DateTime<Utc>>,
    #[serde(default)]
    pub last_succeeded_at: Option<DateTime<Utc>>,
    #[serde(default)]
    pub last_error: Option<String>,
    #[serde(default)]
    pub include_cursor: Option<bool>,
    #[serde(default)]
    pub refreshed: Option<bool>,
}

#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq)]
pub struct ConfiguredRunnerHost {
    pub runner_host_id: String,
    #[serde(default)]
    pub organization_id: Option<String>,
    #[serde(default)]
    pub hostname: Option<String>,
    #[serde(default)]
    pub platform: Option<RunnerPlatform>,
    #[serde(default)]
    pub runtime: Option<RunnerExecutionRuntime>,
    #[serde(default)]
    pub labels: Vec<String>,
    #[serde(default)]
    pub updated_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq)]
pub struct RunnerMachineConfig {
    #[serde(default)]
    pub runtime_root: Option<String>,
    #[serde(default)]
    pub preferred_runtime: Option<RunnerExecutionRuntime>,
    #[serde(default)]
    pub hosts: Vec<ConfiguredRunnerHost>,
}

#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Eq)]
pub struct OpenRouterConfig {
    #[serde(default = "default_openrouter_commit_model")]
    pub commit_model: String,
    #[serde(default = "default_openrouter_release_notes_model")]
    pub release_notes_model: String,
    #[serde(default = "default_openrouter_commit_system_prompt")]
    pub commit_system_prompt: String,
    #[serde(default = "default_openrouter_release_notes_system_prompt")]
    pub release_notes_system_prompt: String,
}

impl Default for OpenRouterConfig {
    fn default() -> Self {
        Self {
            commit_model: default_openrouter_commit_model(),
            release_notes_model: default_openrouter_release_notes_model(),
            commit_system_prompt: default_openrouter_commit_system_prompt(),
            release_notes_system_prompt: default_openrouter_release_notes_system_prompt(),
        }
    }
}

#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct SshConfig {
    pub password: Option<String>,
    pub username: Option<String>,
    pub host: Option<String>,
    pub project_dir: Option<String>,
    #[serde(default)]
    pub xbp_api_token: Option<String>,
    pub openrouter_api_key: Option<String>,
    pub github_oauth2_key: Option<String>,
    #[serde(default)]
    pub cloudflare_api_token: Option<String>,
    #[serde(default)]
    pub cloudflare_account_id: Option<String>,
    pub linear_api_key: Option<String>,
    #[serde(default)]
    pub npm_token: Option<String>,
    #[serde(default)]
    pub crates_token: Option<String>,
    #[serde(default)]
    pub openrouter: OpenRouterConfig,
    #[serde(default)]
    pub linear: Option<LinearConfig>,
    #[serde(default)]
    pub cli_auth: Option<CliAuthState>,
    #[serde(default)]
    pub device: Option<DeviceIdentity>,
    #[serde(default)]
    pub secret_metadata: BTreeMap<String, SecretMetadata>,
    #[serde(default)]
    pub system_inventory: Option<SystemInventory>,
    #[serde(default)]
    pub cursor_ingest: Option<CursorIngestState>,
    #[serde(default)]
    pub system_inventory_refresh: Option<SystemInventoryRefreshState>,
    #[serde(default)]
    pub dns_inventory: Option<DnsInventoryCache>,
    #[serde(default)]
    pub runners: Option<RunnerMachineConfig>,
    /// Client-side worktree-watch path filters (paths, folders, banned words).
    #[serde(default)]
    pub worktree_watch: Option<WorktreeWatchConfig>,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum SecretProvider {
    OpenRouter,
    Github,
    Cloudflare,
    Linear,
    Npm,
    Crates,
}

impl SecretProvider {
    pub fn from_key(key: &str) -> Option<Self> {
        match key.trim().to_ascii_lowercase().as_str() {
            "openrouter" => Some(Self::OpenRouter),
            "github" => Some(Self::Github),
            "cloudflare" => Some(Self::Cloudflare),
            "linear" => Some(Self::Linear),
            "npm" | "npmjs" => Some(Self::Npm),
            "crates" | "crates-io" | "cratesio" => Some(Self::Crates),
            _ => None,
        }
    }

    pub fn as_key(&self) -> &'static str {
        match self {
            SecretProvider::OpenRouter => "openrouter",
            SecretProvider::Github => "github",
            SecretProvider::Cloudflare => "cloudflare",
            SecretProvider::Linear => "linear",
            SecretProvider::Npm => "npm",
            SecretProvider::Crates => "crates",
        }
    }

    pub fn config_field(&self) -> &'static str {
        match self {
            SecretProvider::OpenRouter => "openrouter_api_key",
            SecretProvider::Github => "github_oauth2_key",
            SecretProvider::Cloudflare => "cloudflare_api_token",
            SecretProvider::Linear => "linear_api_key",
            SecretProvider::Npm => "npm_token",
            SecretProvider::Crates => "crates_token",
        }
    }
}

impl Default for SshConfig {
    fn default() -> Self {
        Self::new()
    }
}

impl SshConfig {
    pub fn new() -> Self {
        SshConfig {
            password: None,
            username: None,
            host: None,
            project_dir: None,
            xbp_api_token: None,
            openrouter_api_key: None,
            github_oauth2_key: None,
            cloudflare_api_token: None,
            cloudflare_account_id: None,
            linear_api_key: None,
            npm_token: None,
            crates_token: None,
            openrouter: OpenRouterConfig::default(),
            linear: None,
            cli_auth: None,
            device: None,
            secret_metadata: BTreeMap::new(),
            system_inventory: None,
            cursor_ingest: None,
            system_inventory_refresh: None,
            dns_inventory: None,
            runners: None,
            worktree_watch: None,
        }
    }

    /// Load worktree-watch ignore rules from the global config (client-side only).
    pub fn worktree_watch_config(&self) -> WorktreeWatchConfig {
        self.worktree_watch.clone().unwrap_or_default()
    }

    pub fn get_secret(&self, provider: SecretProvider) -> Option<&str> {
        match provider {
            SecretProvider::OpenRouter => self.openrouter_api_key.as_deref(),
            SecretProvider::Github => self.github_oauth2_key.as_deref(),
            SecretProvider::Cloudflare => self.cloudflare_api_token.as_deref(),
            SecretProvider::Linear => self.linear_api_key.as_deref(),
            SecretProvider::Npm => self.npm_token.as_deref(),
            SecretProvider::Crates => self.crates_token.as_deref(),
        }
    }

    pub fn set_secret(&mut self, provider: SecretProvider, value: Option<String>) {
        match provider {
            SecretProvider::OpenRouter => self.openrouter_api_key = value,
            SecretProvider::Github => self.github_oauth2_key = value,
            SecretProvider::Cloudflare => self.cloudflare_api_token = value,
            SecretProvider::Linear => self.linear_api_key = value,
            SecretProvider::Npm => self.npm_token = value,
            SecretProvider::Crates => self.crates_token = value,
        }

        match self.get_secret(provider) {
            Some(_) => {
                self.secret_metadata.insert(
                    provider.as_key().to_string(),
                    SecretMetadata {
                        added_at: Some(Utc::now()),
                    },
                );
            }
            None => {
                self.secret_metadata.remove(provider.as_key());
            }
        }
    }

    pub fn get_secret_metadata(&self, provider: SecretProvider) -> Option<&SecretMetadata> {
        self.secret_metadata.get(provider.as_key())
    }

    pub fn load() -> Result<Self, String> {
        let config_path = get_config_path();
        let legacy_path = legacy_config_path();
        let path_to_read = if config_path.exists() {
            config_path
        } else if legacy_path.exists() {
            legacy_path
        } else {
            return Ok(SshConfig::new());
        };

        let content = fs::read_to_string(&path_to_read)
            .map_err(|e| format!("Failed to read config file: {}", e))?;
        serde_yaml::from_str(&content).map_err(|e| format!("Failed to parse config file: {}", e))
    }

    pub fn save(&self) -> Result<(), String> {
        let config_path = get_config_path();
        let config_dir = config_path.parent().ok_or("Invalid config path")?;
        fs::create_dir_all(config_dir)
            .map_err(|e| format!("Failed to create config directory: {}", e))?;

        let content = serde_yaml::to_string(self)
            .map_err(|e| format!("Failed to serialize config: {}", e))?;
        fs::write(&config_path, content).map_err(|e| format!("Failed to write config file: {}", e))
    }
}

/// Resolve worktree-watch filters from the global XBP config file (client-side only).
pub fn resolve_worktree_watch_config() -> WorktreeWatchConfig {
    SshConfig::load()
        .ok()
        .map(|cfg| cfg.worktree_watch_config())
        .unwrap_or_default()
}

pub fn global_runner_root_dir() -> Result<PathBuf, String> {
    let paths = ensure_global_xbp_paths()?;
    let config = SshConfig::load().unwrap_or_else(|_| SshConfig::new());
    if let Some(path) = config
        .runners
        .as_ref()
        .and_then(|runners| runners.runtime_root.as_deref())
        .map(str::trim)
        .filter(|value| !value.is_empty())
    {
        let candidate = PathBuf::from(path);
        fs::create_dir_all(&candidate).map_err(|error| {
            format!(
                "Failed to create runner runtime root {}: {}",
                candidate.display(),
                error
            )
        })?;
        return Ok(candidate);
    }

    let default_root = paths.root_dir.join("github").join("runners");
    fs::create_dir_all(&default_root).map_err(|error| {
        format!(
            "Failed to create runner runtime root {}: {}",
            default_root.display(),
            error
        )
    })?;
    Ok(default_root)
}

#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct VersioningFilesConfig {
    #[serde(default = "default_versioning_files")]
    pub files: Vec<String>,
}

impl Default for VersioningFilesConfig {
    fn default() -> Self {
        Self {
            files: default_versioning_files(),
        }
    }
}

#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Eq)]
pub struct PackageNameLookup {
    pub file: String,
    pub format: String,
    pub key: String,
    pub registry: String,
}

#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct PackageNameFilesConfig {
    #[serde(default = "default_package_name_lookups")]
    pub lookups: Vec<PackageNameLookup>,
}

impl Default for PackageNameFilesConfig {
    fn default() -> Self {
        Self {
            lookups: default_package_name_lookups(),
        }
    }
}

pub fn ensure_global_xbp_paths() -> Result<GlobalXbpPaths, String> {
    let root_dir = preferred_global_root_dir();

    let paths = GlobalXbpPaths {
        config_file: root_dir.join("config.yaml"),
        ssh_dir: root_dir.join("ssh"),
        cache_dir: root_dir.join("cache"),
        logs_dir: root_dir.join("logs"),
        versioning_files_file: root_dir.join("versioning-files.yaml"),
        package_name_files_file: root_dir.join("package-name-files.yaml"),
        root_dir,
    };

    for dir in [
        &paths.root_dir,
        &paths.ssh_dir,
        &paths.cache_dir,
        &paths.logs_dir,
    ] {
        fs::create_dir_all(dir)
            .map_err(|e| format!("Failed to create XBP directory {}: {}", dir.display(), e))?;
    }

    maybe_migrate_legacy_windows_files(&paths)?;

    if !paths.config_file.exists() {
        let default_config = serde_yaml::to_string(&SshConfig::new())
            .map_err(|e| format!("Failed to serialize default config: {}", e))?;
        fs::write(&paths.config_file, default_config).map_err(|e| {
            format!(
                "Failed to initialize config file {}: {}",
                paths.config_file.display(),
                e
            )
        })?;
    }
    sync_global_config_defaults_at(&paths.config_file)?;

    sync_versioning_files_registry_at(&paths.versioning_files_file)?;
    sync_package_name_files_registry_at(&paths.package_name_files_file)?;

    Ok(paths)
}

fn default_openrouter_commit_model() -> String {
    DEFAULT_MODEL.to_string()
}

fn default_openrouter_release_notes_model() -> String {
    DEFAULT_MODEL.to_string()
}

fn default_openrouter_commit_system_prompt() -> String {
    DEFAULT_COMMIT_SYSTEM_PROMPT.to_string()
}

fn default_openrouter_release_notes_system_prompt() -> String {
    DEFAULT_RELEASE_NOTES_SYSTEM_PROMPT.to_string()
}

const SYSTEM_INVENTORY_REFRESH_HOURS: i64 = 24;

fn resolve_openrouter_config_value<F>(selector: F, fallback: &str) -> String
where
    F: FnOnce(&OpenRouterConfig) -> &str,
{
    SshConfig::load()
        .ok()
        .map(|cfg| selector(&cfg.openrouter).trim().to_string())
        .filter(|value| !value.is_empty())
        .unwrap_or_else(|| fallback.to_string())
}

fn sync_global_config_defaults_at(config_path: &PathBuf) -> Result<(), String> {
    let content = fs::read_to_string(config_path).map_err(|e| {
        format!(
            "Failed to read config file {}: {}",
            config_path.display(),
            e
        )
    })?;

    if content.contains("openrouter:")
        && content.contains("commit_model:")
        && content.contains("release_notes_model:")
        && content.contains("commit_system_prompt:")
        && content.contains("release_notes_system_prompt:")
    {
        return Ok(());
    }

    let config: SshConfig = serde_yaml::from_str(&content)
        .map_err(|e| format!("Failed to parse config file: {}", e))?;
    let normalized =
        serde_yaml::to_string(&config).map_err(|e| format!("Failed to serialize config: {}", e))?;

    if normalized != content {
        fs::write(config_path, normalized).map_err(|e| {
            format!(
                "Failed to write config file {}: {}",
                config_path.display(),
                e
            )
        })?;
    }

    Ok(())
}

pub fn resolve_openrouter_api_key() -> Option<String> {
    env::var("OPENROUTER_API_KEY")
        .ok()
        .map(|value| value.trim().to_string())
        .filter(|value| !value.is_empty())
        .or_else(|| {
            SshConfig::load()
                .ok()
                .and_then(|cfg| {
                    cfg.get_secret(SecretProvider::OpenRouter)
                        .map(str::to_string)
                })
                .map(|value| value.trim().to_string())
                .filter(|value| !value.is_empty())
        })
}

pub fn resolve_openrouter_commit_model() -> String {
    resolve_openrouter_config_value(|cfg| cfg.commit_model.as_str(), DEFAULT_MODEL)
}

pub fn resolve_openrouter_release_notes_model() -> String {
    resolve_openrouter_config_value(|cfg| cfg.release_notes_model.as_str(), DEFAULT_MODEL)
}

pub fn resolve_openrouter_commit_system_prompt() -> String {
    resolve_openrouter_config_value(
        |cfg| cfg.commit_system_prompt.as_str(),
        DEFAULT_COMMIT_SYSTEM_PROMPT,
    )
}

pub fn resolve_openrouter_release_notes_system_prompt() -> String {
    resolve_openrouter_config_value(
        |cfg| cfg.release_notes_system_prompt.as_str(),
        DEFAULT_RELEASE_NOTES_SYSTEM_PROMPT,
    )
}

pub fn resolve_xbp_api_token() -> Option<String> {
    env::var("XBP_API_TOKEN")
        .ok()
        .map(|value| value.trim().to_string())
        .filter(|value| !value.is_empty())
        .or_else(|| {
            SshConfig::load()
                .ok()
                .and_then(|cfg| cfg.xbp_api_token)
                .map(|value| value.trim().to_string())
                .filter(|value| !value.is_empty())
        })
}

pub fn resolve_github_oauth2_key() -> Option<String> {
    for env_var in [
        "GITHUB_TOKEN",
        "GITHUB_OAUTH2_KEY",
        "GITHUB_OAUTH2_TOKEN",
        "GITHUB_OAUTH_TOKEN",
    ] {
        if let Ok(value) = env::var(env_var) {
            let token = value.trim();
            if !token.is_empty() {
                return Some(token.to_string());
            }
        }
    }

    SshConfig::load()
        .ok()
        .and_then(|cfg| cfg.get_secret(SecretProvider::Github).map(str::to_string))
        .map(|value| value.trim().to_string())
        .filter(|value| !value.is_empty())
}

pub fn resolve_cloudflare_api_token() -> Option<String> {
    env::var("CLOUDFLARE_API_TOKEN")
        .ok()
        .map(|value| value.trim().to_string())
        .filter(|value| !value.is_empty())
        .or_else(|| {
            SshConfig::load()
                .ok()
                .and_then(|cfg| {
                    cfg.get_secret(SecretProvider::Cloudflare)
                        .map(str::to_string)
                })
                .map(|value| value.trim().to_string())
                .filter(|value| !value.is_empty())
        })
}

pub fn cloudflare_account_id_from_process_env() -> Option<String> {
    CLOUDFLARE_ACCOUNT_ID_ENV_KEYS.iter().find_map(|key| {
        env::var(key)
            .ok()
            .map(|value| value.trim().to_string())
            .filter(|value| !value.is_empty())
    })
}

pub fn cloudflare_account_id_from_project_env() -> Option<String> {
    let current_dir = env::current_dir().ok()?;
    let found = find_xbp_config_upwards(&current_dir)?;
    let lookup = load_env_lookup(&found.project_root);
    first_lookup_value(&lookup, CLOUDFLARE_ACCOUNT_ID_ENV_KEYS)
}

pub fn cloudflare_account_id_from_global_config() -> Option<String> {
    SshConfig::load()
        .ok()
        .and_then(|cfg| cfg.cloudflare_account_id)
        .map(|value| value.trim().to_string())
        .filter(|value| !value.is_empty())
}

pub fn resolve_cloudflare_account_id() -> Option<String> {
    cloudflare_account_id_from_process_env()
        .or_else(cloudflare_account_id_from_project_env)
        .or_else(cloudflare_account_id_from_global_config)
}

pub fn resolve_linear_api_key() -> Option<String> {
    SshConfig::load()
        .ok()
        .and_then(|cfg| cfg.get_secret(SecretProvider::Linear).map(str::to_string))
        .map(|value| value.trim().to_string())
        .filter(|value| !value.is_empty())
}

pub fn resolve_npm_token() -> Option<String> {
    for env_var in ["NPM_TOKEN", "NODE_AUTH_TOKEN"] {
        if let Ok(value) = env::var(env_var) {
            let token = value.trim();
            if !token.is_empty() {
                return Some(token.to_string());
            }
        }
    }

    SshConfig::load()
        .ok()
        .and_then(|cfg| cfg.get_secret(SecretProvider::Npm).map(str::to_string))
        .map(|value| value.trim().to_string())
        .filter(|value| !value.is_empty())
}

pub fn resolve_crates_token() -> Option<String> {
    for env_var in ["CARGO_REGISTRY_TOKEN", "CRATES_IO_TOKEN"] {
        if let Ok(value) = env::var(env_var) {
            let token = value.trim();
            if !token.is_empty() {
                return Some(token.to_string());
            }
        }
    }

    SshConfig::load()
        .ok()
        .and_then(|cfg| cfg.get_secret(SecretProvider::Crates).map(str::to_string))
        .map(|value| value.trim().to_string())
        .filter(|value| !value.is_empty())
}

pub fn set_cloudflare_account_id(value: Option<String>) -> Result<(), String> {
    let mut config = SshConfig::load()?;
    config.cloudflare_account_id = value;
    config.save()
}

pub fn get_cloudflare_account_id() -> Result<Option<String>, String> {
    Ok(SshConfig::load()?.cloudflare_account_id)
}

pub fn resolve_global_linear_release_config() -> Option<LinearReleaseConfig> {
    SshConfig::load()
        .ok()
        .and_then(|cfg| cfg.linear.and_then(|linear| linear.release))
}

pub fn resolve_device_identity() -> Result<DeviceIdentity, String> {
    ensure_global_xbp_paths()?;
    let mut config = SshConfig::load()?;
    if let Some(device) = config.device.clone() {
        if !device.hardware_id.trim().is_empty() {
            return Ok(device);
        }
    }

    let hardware_id = format!("xbp_hw_{}", uuid::Uuid::new_v4());
    let device = DeviceIdentity {
        hardware_id,
        created_at: Some(Utc::now()),
    };
    config.device = Some(device.clone());
    config.save()?;
    Ok(device)
}

pub fn reserve_cursor_ingest_slot(
    trigger: &str,
    mode: &str,
    min_interval: ChronoDuration,
) -> Result<bool, String> {
    ensure_global_xbp_paths()?;
    let mut config = SshConfig::load()?;
    let now = Utc::now();

    if let Some(state) = config.cursor_ingest.as_ref() {
        if let Some(last_attempted_at) = state.last_attempted_at {
            if now - last_attempted_at < min_interval {
                return Ok(false);
            }
        }
    }

    let mut state = config.cursor_ingest.unwrap_or_default();
    state.last_status = Some("scheduled".to_string());
    state.last_trigger = Some(trigger.to_string());
    state.last_mode = Some(mode.to_string());
    state.last_attempted_at = Some(now);
    state.last_error = None;
    config.cursor_ingest = Some(state);
    config.save()?;
    Ok(true)
}

pub fn record_cursor_ingest_started(trigger: &str, mode: &str) -> Result<(), String> {
    let mut config = SshConfig::load().unwrap_or_else(|_| SshConfig::new());
    let mut state = config.cursor_ingest.unwrap_or_default();
    state.last_status = Some("running".to_string());
    state.last_trigger = Some(trigger.to_string());
    state.last_mode = Some(mode.to_string());
    state.last_attempted_at = Some(Utc::now());
    state.last_error = None;
    config.cursor_ingest = Some(state);
    config.save()
}

pub fn record_cursor_ingest_success(
    trigger: &str,
    mode: &str,
    workspace_count: usize,
    entry_count: usize,
    entries_skipped: usize,
) -> Result<(), String> {
    let mut config = SshConfig::load().unwrap_or_else(|_| SshConfig::new());
    let mut state = config.cursor_ingest.unwrap_or_default();
    let completed_at = Utc::now();
    state.last_status = Some("success".to_string());
    state.last_trigger = Some(trigger.to_string());
    state.last_mode = Some(mode.to_string());
    state.last_attempted_at = Some(completed_at);
    state.last_succeeded_at = Some(completed_at);
    state.last_error = None;
    state.last_workspace_count = Some(workspace_count);
    state.last_entry_count = Some(entry_count);
    state.last_entries_skipped = Some(entries_skipped);
    config.cursor_ingest = Some(state);
    config.save()
}

pub fn record_cursor_ingest_failure(trigger: &str, mode: &str, error: &str) -> Result<(), String> {
    let mut config = SshConfig::load().unwrap_or_else(|_| SshConfig::new());
    let mut state = config.cursor_ingest.unwrap_or_default();
    state.last_status = Some("failed".to_string());
    state.last_trigger = Some(trigger.to_string());
    state.last_mode = Some(mode.to_string());
    state.last_attempted_at = Some(Utc::now());
    state.last_error = Some(error.chars().take(400).collect());
    config.cursor_ingest = Some(state);
    config.save()
}

pub fn reserve_system_inventory_refresh_slot(
    trigger: &str,
    mode: &str,
    include_cursor: bool,
    min_interval: ChronoDuration,
) -> Result<bool, String> {
    ensure_global_xbp_paths()?;
    let mut config = SshConfig::load()?;
    let now = Utc::now();

    if let Some(existing) = config.system_inventory.as_ref() {
        if !system_inventory_needs_refresh(existing, include_cursor) {
            return Ok(false);
        }
    }

    if let Some(state) = config.system_inventory_refresh.as_ref() {
        if let Some(last_attempted_at) = state.last_attempted_at {
            if now - last_attempted_at < min_interval {
                return Ok(false);
            }
        }
    }

    let mut state = config.system_inventory_refresh.unwrap_or_default();
    state.last_status = Some("scheduled".to_string());
    state.last_trigger = Some(trigger.to_string());
    state.last_mode = Some(mode.to_string());
    state.last_attempted_at = Some(now);
    state.last_error = None;
    state.include_cursor = Some(include_cursor);
    config.system_inventory_refresh = Some(state);
    config.save()?;
    Ok(true)
}

pub fn record_system_inventory_refresh_started(
    trigger: &str,
    mode: &str,
    include_cursor: bool,
) -> Result<(), String> {
    let mut config = SshConfig::load().unwrap_or_else(|_| SshConfig::new());
    let mut state = config.system_inventory_refresh.unwrap_or_default();
    state.last_status = Some("running".to_string());
    state.last_trigger = Some(trigger.to_string());
    state.last_mode = Some(mode.to_string());
    state.last_attempted_at = Some(Utc::now());
    state.last_error = None;
    state.include_cursor = Some(include_cursor);
    config.system_inventory_refresh = Some(state);
    config.save()
}

pub fn record_system_inventory_refresh_success(
    trigger: &str,
    mode: &str,
    include_cursor: bool,
    refreshed: bool,
) -> Result<(), String> {
    let mut config = SshConfig::load().unwrap_or_else(|_| SshConfig::new());
    let mut state = config.system_inventory_refresh.unwrap_or_default();
    let completed_at = Utc::now();
    state.last_status = Some("success".to_string());
    state.last_trigger = Some(trigger.to_string());
    state.last_mode = Some(mode.to_string());
    state.last_attempted_at = Some(completed_at);
    state.last_succeeded_at = Some(completed_at);
    state.last_error = None;
    state.include_cursor = Some(include_cursor);
    state.refreshed = Some(refreshed);
    config.system_inventory_refresh = Some(state);
    config.save()
}

pub fn record_system_inventory_refresh_failure(
    trigger: &str,
    mode: &str,
    include_cursor: bool,
    error: &str,
) -> Result<(), String> {
    let mut config = SshConfig::load().unwrap_or_else(|_| SshConfig::new());
    let mut state = config.system_inventory_refresh.unwrap_or_default();
    state.last_status = Some("failed".to_string());
    state.last_trigger = Some(trigger.to_string());
    state.last_mode = Some(mode.to_string());
    state.last_attempted_at = Some(Utc::now());
    state.last_error = Some(error.chars().take(400).collect());
    state.include_cursor = Some(include_cursor);
    config.system_inventory_refresh = Some(state);
    config.save()
}

pub fn update_dns_inventory_cache<F>(updater: F) -> Result<(), String>
where
    F: FnOnce(&mut DnsInventoryCache),
{
    ensure_global_xbp_paths()?;
    let mut config = SshConfig::load()?;
    let mut cache = config.dns_inventory.unwrap_or_default();
    updater(&mut cache);
    config.dns_inventory = Some(cache);
    config.save()
}

pub fn sync_system_inventory(
    force: bool,
    include_cursor: bool,
    current_dir: Option<&Path>,
) -> Result<SystemInventorySyncResult, String> {
    let paths = ensure_global_xbp_paths()?;
    let mut config = SshConfig::load()?;

    if !force {
        if let Some(existing) = config.system_inventory.clone() {
            if !system_inventory_needs_refresh(&existing, include_cursor) {
                return Ok(SystemInventorySyncResult {
                    inventory: existing,
                    config_path: paths.config_file,
                    refreshed: false,
                });
            }
        }
    }

    let mut options = SystemInventoryOptions {
        include_cursor,
        current_dir: current_dir.map(Path::to_path_buf),
        xbp_global_root: Some(paths.root_dir.clone()),
    };
    if options.current_dir.is_none() {
        options.current_dir = env::current_dir().ok();
    }

    let mut inventory = collect_codetime_system_inventory(&options);
    if !include_cursor {
        if let Some(existing_cursor) = config
            .system_inventory
            .as_ref()
            .and_then(|existing| existing.cursor.clone())
        {
            inventory.cursor = Some(existing_cursor);
        }
    }

    config.system_inventory = Some(inventory.clone());
    config.save()?;

    Ok(SystemInventorySyncResult {
        inventory,
        config_path: paths.config_file,
        refreshed: true,
    })
}

fn system_inventory_needs_refresh(inventory: &SystemInventory, include_cursor: bool) -> bool {
    if include_cursor && inventory.cursor.is_none() {
        return true;
    }

    match inventory.collected_at {
        Some(collected_at) => {
            Utc::now() - collected_at >= ChronoDuration::hours(SYSTEM_INVENTORY_REFRESH_HOURS)
        }
        None => true,
    }
}

pub fn global_xbp_paths() -> Result<GlobalXbpPaths, String> {
    ensure_global_xbp_paths()
}

pub fn get_config_path() -> PathBuf {
    ensure_global_xbp_paths()
        .map(|paths| paths.config_file)
        .unwrap_or_else(|_| legacy_config_path())
}

#[cfg(target_os = "windows")]
fn legacy_config_path() -> PathBuf {
    dirs::config_dir()
        .unwrap_or_else(|| PathBuf::from("."))
        .join("xbp")
        .join("config.yaml")
}

#[cfg(not(target_os = "windows"))]
fn legacy_config_path() -> PathBuf {
    dirs::home_dir()
        .unwrap_or_else(|| PathBuf::from("."))
        .join(".xbp")
        .join("config.yaml")
}

/// Resolve the global `~/.xbp` (or platform equivalent) root.
///
/// On WSL this prefers an already-established Windows profile root when it is
/// reachable via `/mnt/<drive>/Users/...`, so worktree-watch spoils and config
/// stay reconcilable with native Windows installs of the same machine.
pub fn resolve_global_xbp_root_dir() -> PathBuf {
    preferred_global_root_dir()
}

#[cfg(test)]
mod global_root_tests {
    use super::{map_windows_path_to_wsl_mnt, map_wsl_mnt_path_to_windows, score_xbp_root};
    use std::path::Path;

    #[test]
    fn maps_windows_and_wsl_paths_both_ways() {
        assert_eq!(
            map_windows_path_to_wsl_mnt(r"C:\Users\szymon\.xbp"),
            Some("/mnt/c/Users/szymon/.xbp".to_string())
        );
        assert_eq!(
            map_wsl_mnt_path_to_windows("/mnt/c/Users/szymon/.xbp"),
            Some("C:/Users/szymon/.xbp".to_string())
        );
    }

    #[test]
    fn scores_missing_root_as_zero() {
        assert_eq!(score_xbp_root(Path::new("/definitely/not/an/xbp/root")), 0);
    }
}

fn preferred_global_root_dir() -> PathBuf {
    if let Some(explicit) = explicit_xbp_home_from_env() {
        return explicit;
    }

    let candidates = collect_global_xbp_root_candidates();
    if let Some(best) = pick_established_xbp_root(&candidates) {
        return best;
    }

    // Fresh install defaults.
    #[cfg(target_os = "windows")]
    {
        if let Some(home_dir) = resolve_windows_home_dir() {
            let c_drive = Path::new(r"C:\");
            if c_drive.exists() {
                if windows_drive_letter(&home_dir) == Some('C') {
                    return home_dir.join(".xbp");
                }
                if let Some(relative_profile_path) = windows_path_without_drive(&home_dir) {
                    let c_profile_candidate = c_drive.join(relative_profile_path);
                    if c_profile_candidate.exists() {
                        return c_profile_candidate.join(".xbp");
                    }
                }
            }
            return home_dir.join(".xbp");
        }
        return dirs::config_dir()
            .or_else(|| dirs::home_dir().map(|home| home.join(".config")))
            .unwrap_or_else(|| PathBuf::from("."))
            .join("xbp");
    }

    #[cfg(not(target_os = "windows"))]
    {
        // Prefer classic ~/.xbp over ~/.config/xbp so WSL/Linux matches Windows
        // layout and worktree-watch spoils stay discoverable.
        if let Some(home) = dirs::home_dir() {
            return home.join(".xbp");
        }
        dirs::config_dir()
            .unwrap_or_else(|| PathBuf::from("."))
            .join("xbp")
    }
}

fn explicit_xbp_home_from_env() -> Option<PathBuf> {
    for key in ["XBP_HOME", "XBP_CONFIG_HOME", "XBP_GLOBAL_ROOT"] {
        if let Ok(value) = env::var(key) {
            let trimmed = value.trim();
            if !trimmed.is_empty() {
                return Some(PathBuf::from(trimmed));
            }
        }
    }
    None
}

fn collect_global_xbp_root_candidates() -> Vec<PathBuf> {
    let mut candidates: Vec<PathBuf> = Vec::new();
    let mut push = |path: PathBuf| {
        if candidates
            .iter()
            .any(|existing| path_keys_equivalent(existing.as_path(), path.as_path()))
        {
            return;
        }
        candidates.push(path);
    };

    if let Some(explicit) = explicit_xbp_home_from_env() {
        push(explicit);
    }

    #[cfg(target_os = "windows")]
    {
        if let Some(home_dir) = resolve_windows_home_dir() {
            push(home_dir.join(".xbp"));
            if let Some(relative) = windows_path_without_drive(&home_dir) {
                push(Path::new(r"C:\").join(relative).join(".xbp"));
            }
        }
        if let Some(config_dir) = dirs::config_dir() {
            push(config_dir.join("xbp"));
        }
    }

    #[cfg(not(target_os = "windows"))]
    {
        if let Some(home) = dirs::home_dir() {
            push(home.join(".xbp"));
            push(home.join(".config").join("xbp"));
        }
        if let Some(config_dir) = dirs::config_dir() {
            push(config_dir.join("xbp"));
        }

        // WSL: discover the Windows user profile .xbp that native Windows uses.
        for windows_home in discover_windows_profile_homes_from_unix() {
            push(windows_home.join(".xbp"));
        }
    }

    candidates
}

fn pick_established_xbp_root(candidates: &[PathBuf]) -> Option<PathBuf> {
    candidates
        .iter()
        .map(|path| (score_xbp_root(path), path.clone()))
        .filter(|(score, _)| *score > 0)
        .max_by(|left, right| left.0.cmp(&right.0).then_with(|| {
            // Prefer Windows-drive-backed roots when scores tie (shared WSL/Windows).
            let left_windows = is_windows_drive_backed_path(&left.1);
            let right_windows = is_windows_drive_backed_path(&right.1);
            right_windows.cmp(&left_windows)
        }))
        .map(|(_, path)| path)
}

fn score_xbp_root(root: &Path) -> u64 {
    if !root.exists() {
        return 0;
    }

    let mut score = 1u64;
    if root.join("config.yaml").is_file() {
        score += 100;
    }
    if root.join("config.yml").is_file() {
        score += 80;
    }
    let mutations = root.join("mutations");
    if mutations.is_dir() {
        score += 50;
        score += count_dir_entries_capped(&mutations, 40).saturating_mul(2);
    }
    if root.join("ssh").is_dir() {
        score += 10;
    }
    if root.join("cache").is_dir() {
        score += 5;
    }
    // Strong signal that this is the shared Windows profile used from WSL.
    if is_windows_drive_backed_path(root) && root.join("config.yaml").is_file() {
        score += 40;
    }
    score
}

fn count_dir_entries_capped(path: &Path, cap: u64) -> u64 {
    let Ok(entries) = fs::read_dir(path) else {
        return 0;
    };
    let mut count = 0u64;
    for _entry in entries.flatten() {
        count += 1;
        if count >= cap {
            break;
        }
    }
    count
}

fn is_windows_drive_backed_path(path: &Path) -> bool {
    let normalized = path.to_string_lossy().replace('\\', "/");
    if cfg!(windows) {
        return windows_drive_letter(path).is_some();
    }
    // WSL mounts of Windows drives: /mnt/c/Users/...
    let lower = normalized.to_ascii_lowercase();
    lower.starts_with("/mnt/")
        && lower.len() >= 6
        && lower.as_bytes().get(5).is_some_and(|b| b.is_ascii_alphabetic())
}

fn path_keys_equivalent(left: &Path, right: &Path) -> bool {
    normalize_path_key(left) == normalize_path_key(right)
}

fn normalize_path_key(path: &Path) -> String {
    let mut value = path.to_string_lossy().replace('\\', "/");
    // Collapse Windows drive letters to a comparable form with WSL /mnt/<drive>/.
    if let Some(mapped) = map_windows_path_to_wsl_mnt(&value) {
        value = mapped;
    } else if let Some(mapped) = map_wsl_mnt_path_to_windows(&value) {
        // Normalize both directions to the /mnt form for comparison on Unix.
        if let Some(mnt) = map_windows_path_to_wsl_mnt(&mapped) {
            value = mnt;
        } else {
            value = mapped;
        }
    }
    if cfg!(windows) {
        value.to_ascii_lowercase()
    } else {
        value
    }
}

/// `C:\Users\foo` → `/mnt/c/Users/foo` (for comparison / WSL access).
pub fn map_windows_path_to_wsl_mnt(path: &str) -> Option<String> {
    let normalized = path.trim().replace('\\', "/");
    let bytes = normalized.as_bytes();
    if bytes.len() >= 2 && bytes[0].is_ascii_alphabetic() && bytes[1] == b':' {
        let drive = (bytes[0] as char).to_ascii_lowercase();
        let rest = normalized.get(2..).unwrap_or("").trim_start_matches('/');
        if rest.is_empty() {
            return Some(format!("/mnt/{drive}"));
        }
        return Some(format!("/mnt/{drive}/{rest}"));
    }
    None
}

/// `/mnt/c/Users/foo` → `C:/Users/foo`.
pub fn map_wsl_mnt_path_to_windows(path: &str) -> Option<String> {
    let normalized = path.trim().replace('\\', "/");
    let rest = normalized.strip_prefix("/mnt/")?;
    let mut parts = rest.splitn(2, '/');
    let drive = parts.next()?.chars().next()?;
    if !drive.is_ascii_alphabetic() {
        return None;
    }
    let tail = parts.next().unwrap_or("");
    if tail.is_empty() {
        Some(format!("{}:", drive.to_ascii_uppercase()))
    } else {
        Some(format!("{}:/{}", drive.to_ascii_uppercase(), tail))
    }
}

#[cfg(not(target_os = "windows"))]
fn discover_windows_profile_homes_from_unix() -> Vec<PathBuf> {
    let mut homes: Vec<PathBuf> = Vec::new();
    let mut push_home = |path: PathBuf| {
        if path.is_dir()
            && !homes
                .iter()
                .any(|existing| path_keys_equivalent(existing.as_path(), path.as_path()))
        {
            homes.push(path);
        }
    };

    // Explicit Windows profile exported into the WSL environment.
    for key in ["USERPROFILE", "WIN_HOME", "WINDOWS_HOME"] {
        if let Ok(value) = env::var(key) {
            let trimmed = value.trim();
            if trimmed.is_empty() {
                continue;
            }
            if let Some(mnt) = map_windows_path_to_wsl_mnt(trimmed) {
                push_home(PathBuf::from(mnt));
            }
            // Already a WSL path.
            if trimmed.starts_with("/mnt/") {
                push_home(PathBuf::from(trimmed));
            }
        }
    }

    // `cmd.exe /c echo %USERPROFILE%` is the most reliable user mapping on WSL.
    if let Some(profile) = query_windows_userprofile_via_cmd() {
        if let Some(mnt) = map_windows_path_to_wsl_mnt(&profile) {
            push_home(PathBuf::from(mnt));
        }
    }

    // Heuristic: /mnt/c/Users/<name> matching Linux username or common aliases.
    if let Some(linux_user) = env::var_os("USER").map(|u| u.to_string_lossy().to_string()) {
        for drive in b'c'..=b'z' {
            let users_dir = PathBuf::from(format!("/mnt/{}/Users", drive as char));
            if !users_dir.is_dir() {
                continue;
            }
            let direct = users_dir.join(&linux_user);
            if direct.is_dir() {
                push_home(direct);
            }
            // Case-insensitive scan for a single matching profile when names differ
            // only by case (Windows vs Linux username).
            if let Ok(entries) = fs::read_dir(&users_dir) {
                for entry in entries.flatten() {
                    let name = entry.file_name().to_string_lossy().to_string();
                    if name.eq_ignore_ascii_case(&linux_user) {
                        push_home(entry.path());
                    }
                }
            }
            // Only probe C: thoroughly; other drives are rare for profiles.
            if drive == b'c' {
                break;
            }
        }
    }

    homes
}

#[cfg(not(target_os = "windows"))]
fn query_windows_userprofile_via_cmd() -> Option<String> {
    // Only attempt on WSL-like environments to avoid hanging on pure Linux.
    let is_wsl = env::var_os("WSL_DISTRO_NAME").is_some()
        || env::var_os("WSL_INTEROP").is_some()
        || fs::read_to_string("/proc/version")
            .map(|content| {
                let lower = content.to_ascii_lowercase();
                lower.contains("microsoft") || lower.contains("wsl")
            })
            .unwrap_or(false);
    if !is_wsl {
        return None;
    }

    let output = std::process::Command::new("cmd.exe")
        .args(["/C", "echo %USERPROFILE%"])
        .output()
        .ok()?;
    if !output.status.success() {
        return None;
    }
    let stdout = String::from_utf8_lossy(&output.stdout);
    let profile = stdout
        .lines()
        .map(str::trim)
        .find(|line| !line.is_empty() && !line.eq_ignore_ascii_case("%USERPROFILE%"))?
        .to_string();
    if profile.is_empty() {
        None
    } else {
        Some(profile)
    }
}

#[cfg(target_os = "windows")]
fn resolve_windows_home_dir() -> Option<PathBuf> {
    dirs::home_dir()
        .or_else(|| env::var_os("USERPROFILE").map(PathBuf::from))
        .or_else(|| {
            let drive = env::var_os("HOMEDRIVE")?;
            let path = env::var_os("HOMEPATH")?;
            Some(PathBuf::from(drive).join(path))
        })
}

fn windows_drive_letter(path: &Path) -> Option<char> {
    let normalized = path.to_string_lossy().replace('/', "\\");
    let bytes = normalized.as_bytes();
    if bytes.len() >= 2 && bytes[0].is_ascii_alphabetic() && bytes[1] == b':' {
        Some((bytes[0] as char).to_ascii_uppercase())
    } else {
        None
    }
}

#[cfg(target_os = "windows")]
fn windows_path_without_drive(path: &Path) -> Option<PathBuf> {
    let normalized = path.to_string_lossy().replace('/', "\\");
    let bytes = normalized.as_bytes();
    if bytes.len() >= 3 && bytes[0].is_ascii_alphabetic() && bytes[1] == b':' && bytes[2] == b'\\' {
        let tail = &normalized[3..];
        if tail.is_empty() {
            Some(PathBuf::new())
        } else {
            Some(PathBuf::from(tail))
        }
    } else {
        None
    }
}

#[cfg(target_os = "windows")]
fn maybe_migrate_legacy_windows_files(paths: &GlobalXbpPaths) -> Result<(), String> {
    let Some(legacy_root) = dirs::config_dir().map(|dir| dir.join("xbp")) else {
        return Ok(());
    };

    migrate_legacy_windows_file_if_missing(&legacy_root.join("config.yaml"), &paths.config_file)?;
    migrate_legacy_windows_file_if_missing(
        &legacy_root.join("versioning-files.yaml"),
        &paths.versioning_files_file,
    )?;
    migrate_legacy_windows_file_if_missing(
        &legacy_root.join("package-name-files.yaml"),
        &paths.package_name_files_file,
    )?;

    Ok(())
}

#[cfg(not(target_os = "windows"))]
fn maybe_migrate_legacy_windows_files(_paths: &GlobalXbpPaths) -> Result<(), String> {
    Ok(())
}

#[cfg(target_os = "windows")]
fn migrate_legacy_windows_file_if_missing(from: &Path, to: &Path) -> Result<(), String> {
    if to.exists() || !from.exists() {
        return Ok(());
    }

    if let Some(parent) = to.parent() {
        fs::create_dir_all(parent).map_err(|e| {
            format!(
                "Failed to create directory for migrated file {}: {}",
                parent.display(),
                e
            )
        })?;
    }

    fs::copy(from, to).map_err(|e| {
        format!(
            "Failed to migrate legacy config file {} -> {}: {}",
            from.display(),
            to.display(),
            e
        )
    })?;

    Ok(())
}

pub fn describe_global_xbp_paths() -> Result<Vec<(String, PathBuf)>, String> {
    let paths = global_xbp_paths()?;
    Ok(vec![
        ("root".to_string(), paths.root_dir),
        ("config".to_string(), paths.config_file),
        ("ssh".to_string(), paths.ssh_dir),
        ("cache".to_string(), paths.cache_dir),
        ("logs".to_string(), paths.logs_dir),
        ("versioning".to_string(), paths.versioning_files_file),
        ("package-names".to_string(), paths.package_name_files_file),
    ])
}

pub fn sync_versioning_files_registry() -> Result<PathBuf, String> {
    let paths = ensure_global_xbp_paths()?;
    Ok(paths.versioning_files_file)
}

pub fn load_versioning_files_registry() -> Result<Vec<String>, String> {
    let registry_path = sync_versioning_files_registry()?;
    let content = fs::read_to_string(&registry_path).map_err(|e| {
        format!(
            "Failed to read versioning registry {}: {}",
            registry_path.display(),
            e
        )
    })?;

    let config: VersioningFilesConfig = serde_yaml::from_str(&content)
        .map_err(|e| format!("Failed to parse versioning registry: {}", e))?;

    Ok(config.files)
}

pub fn sync_package_name_files_registry() -> Result<PathBuf, String> {
    let paths = ensure_global_xbp_paths()?;
    Ok(paths.package_name_files_file)
}

pub fn load_package_name_files_registry() -> Result<Vec<PackageNameLookup>, String> {
    let registry_path = sync_package_name_files_registry()?;
    let content = fs::read_to_string(&registry_path).map_err(|e| {
        format!(
            "Failed to read package-name registry {}: {}",
            registry_path.display(),
            e
        )
    })?;

    let config: PackageNameFilesConfig = serde_yaml::from_str(&content)
        .map_err(|e| format!("Failed to parse package-name registry: {}", e))?;

    Ok(config.lookups)
}

fn sync_versioning_files_registry_at(path: &PathBuf) -> Result<(), String> {
    let mut config = if path.exists() {
        let content = fs::read_to_string(path).map_err(|e| {
            format!(
                "Failed to read versioning registry {}: {}",
                path.display(),
                e
            )
        })?;
        serde_yaml::from_str::<VersioningFilesConfig>(&content)
            .unwrap_or_else(|_| VersioningFilesConfig::default())
    } else {
        VersioningFilesConfig::default()
    };

    let mut changed = false;
    for default_file in default_versioning_files() {
        if !config
            .files
            .iter()
            .any(|existing| existing == &default_file)
        {
            config.files.push(default_file);
            changed = true;
        }
    }

    if changed || !path.exists() {
        let content = serde_yaml::to_string(&config)
            .map_err(|e| format!("Failed to serialize versioning registry: {}", e))?;
        fs::write(path, content).map_err(|e| {
            format!(
                "Failed to write versioning registry {}: {}",
                path.display(),
                e
            )
        })?;
    }

    Ok(())
}

fn sync_package_name_files_registry_at(path: &PathBuf) -> Result<(), String> {
    let mut config = if path.exists() {
        let content = fs::read_to_string(path).map_err(|e| {
            format!(
                "Failed to read package-name registry {}: {}",
                path.display(),
                e
            )
        })?;
        serde_yaml::from_str::<PackageNameFilesConfig>(&content)
            .unwrap_or_else(|_| PackageNameFilesConfig::default())
    } else {
        PackageNameFilesConfig::default()
    };

    let mut changed = false;
    for default_lookup in default_package_name_lookups() {
        if !config
            .lookups
            .iter()
            .any(|existing| existing == &default_lookup)
        {
            config.lookups.push(default_lookup);
            changed = true;
        }
    }

    if changed || !path.exists() {
        let content = serde_yaml::to_string(&config)
            .map_err(|e| format!("Failed to serialize package-name registry: {}", e))?;
        fs::write(path, content).map_err(|e| {
            format!(
                "Failed to write package-name registry {}: {}",
                path.display(),
                e
            )
        })?;
    }

    Ok(())
}

fn default_versioning_files() -> Vec<String> {
    vec![
        "README.md".to_string(),
        "openapi.yaml".to_string(),
        "openapi.yml".to_string(),
        "openapi.json".to_string(),
        "package.json".to_string(),
        "package-lock.json".to_string(),
        "Cargo.toml".to_string(),
        "Cargo.lock".to_string(),
        "pyproject.toml".to_string(),
        "composer.json".to_string(),
        "deno.json".to_string(),
        "deno.jsonc".to_string(),
        "Chart.yaml".to_string(),
        "app.json".to_string(),
        "manifest.json".to_string(),
        "pom.xml".to_string(),
        "build.gradle".to_string(),
        "build.gradle.kts".to_string(),
        "mix.exs".to_string(),
        "xbp.yaml".to_string(),
        "xbp.yml".to_string(),
        "xbp.json".to_string(),
        ".xbp/xbp.json".to_string(),
        ".xbp/xbp.yaml".to_string(),
        ".xbp/xbp.yml".to_string(),
    ]
}

fn default_package_name_lookups() -> Vec<PackageNameLookup> {
    vec![
        PackageNameLookup {
            file: "package.json".to_string(),
            format: "json".to_string(),
            key: "name".to_string(),
            registry: "npm".to_string(),
        },
        PackageNameLookup {
            file: "Cargo.toml".to_string(),
            format: "toml".to_string(),
            key: "package.name".to_string(),
            registry: "crates.io".to_string(),
        },
    ]
}

const DEFAULT_API_XBP_URL: &str = "https://api.xbp.app";

/// Simple API configuration for the XBP version endpoints.
#[derive(Debug, Clone)]
pub struct ApiConfig {
    base_url: String,
}

impl ApiConfig {
    /// Load the API configuration from API_XBP_URL, falling back to the default.
    pub fn load() -> Self {
        let raw_url = env::var("API_XBP_URL").unwrap_or_else(|_| DEFAULT_API_XBP_URL.to_string());
        Self::from_base_url(&raw_url)
    }

    pub fn from_env() -> Self {
        Self::load()
    }

    pub fn from_base_url(raw_url: &str) -> Self {
        let base_url = Self::normalize_base_url(raw_url);
        ApiConfig { base_url }
    }

    /// Return the normalized base URL that downstream callers should use.
    pub fn base_url(&self) -> &str {
        &self.base_url
    }

    /// Build the version query endpoint.
    pub fn version_endpoint(&self, project_name: &str) -> String {
        format!("{}/version?project_name={}", self.base_url, project_name)
    }

    /// Build the endpoint that increments a version.
    pub fn increment_endpoint(&self) -> String {
        format!("{}/version/increment", self.base_url)
    }

    pub fn web_base_url(&self) -> String {
        Self::derive_web_base_url(&self.base_url)
    }

    pub fn cli_auth_request_endpoint(&self) -> String {
        format!("{}/api/cli/auth/request", self.web_base_url())
    }

    pub fn cli_auth_poll_endpoint(&self) -> String {
        format!("{}/api/cli/auth/poll", self.web_base_url())
    }

    pub fn cli_auth_session_endpoint(&self) -> String {
        format!("{}/api/cli/auth/session", self.web_base_url())
    }

    pub fn cli_auth_browser_url(&self, flow_id: &str) -> String {
        format!("{}/cli/login/{}", self.web_base_url(), flow_id)
    }

    pub fn cli_linear_key_endpoint(&self) -> String {
        format!("{}/api/cli/linear/key", self.web_base_url())
    }

    pub fn cli_cloudflare_credentials_endpoint(&self) -> String {
        format!("{}/api/cli/cloudflare/credentials", self.web_base_url())
    }

    pub fn cloudflare_settings_url(&self) -> String {
        format!("{}/settings/cloudflare", self.web_base_url())
    }

    pub fn cli_version_activity_endpoint(&self) -> String {
        format!("{}/api/cli/version/activity", self.web_base_url())
    }

    pub fn cli_cursor_ingest_endpoint(&self) -> String {
        format!("{}/api/cli/cursor/ingest", self.web_base_url())
    }

    pub fn cli_projects_register_endpoint(&self) -> String {
        format!("{}/api/cli/projects/register", self.web_base_url())
    }

    pub fn cli_worktree_mutations_endpoint(&self) -> String {
        format!("{}/api/cli/worktree-mutations/ingest", self.web_base_url())
    }

    pub fn cli_secrets_sync_endpoint(&self) -> String {
        format!("{}/api/cli/secrets/sync", self.web_base_url())
    }

    pub fn cli_secrets_list_endpoint(&self) -> String {
        format!("{}/api/cli/secrets", self.web_base_url())
    }

    pub fn cli_openapi_upload_endpoint(&self) -> String {
        format!("{}/api/cli/openapi/upload", self.web_base_url())
    }

    pub fn cli_openapi_list_endpoint(&self) -> String {
        format!("{}/api/cli/openapi", self.web_base_url())
    }

    fn normalize_base_url(raw: &str) -> String {
        let trimmed = raw.trim();
        if trimmed.is_empty() {
            return DEFAULT_API_XBP_URL.to_string();
        }

        let trimmed = trimmed.trim_end_matches('/');
        if trimmed.is_empty() {
            return DEFAULT_API_XBP_URL.to_string();
        }

        trimmed.to_string()
    }

    fn derive_web_base_url(base_url: &str) -> String {
        let Ok(mut url) = Url::parse(base_url) else {
            return base_url.to_string();
        };

        if let Some(host) = url.host_str().map(str::to_string) {
            if host == "api.xbp.app" || (host.starts_with("api.") && host.ends_with(".xbp.app")) {
                let _ = url.set_host(Some("xbp.app"));
            } else if let Some(stripped) = host.strip_prefix("api.") {
                let _ = url.set_host(Some(stripped));
            }
        }

        url.set_path("");
        url.set_query(None);
        url.set_fragment(None);

        url.to_string().trim_end_matches('/').to_string()
    }
}

#[cfg(test)]
mod tests {
    use super::{
        cloudflare_account_id_from_project_env, default_package_name_lookups,
        default_versioning_files, resolve_cloudflare_account_id, resolve_github_oauth2_key,
        resolve_openrouter_api_key, resolve_xbp_api_token, sync_global_config_defaults_at,
        sync_package_name_files_registry_at, sync_versioning_files_registry_at, ApiConfig,
        OpenRouterConfig, PackageNameFilesConfig, SecretProvider, SshConfig, VersioningFilesConfig,
    };
    use crate::openrouter::{
        DEFAULT_COMMIT_SYSTEM_PROMPT, DEFAULT_MODEL, DEFAULT_RELEASE_NOTES_SYSTEM_PROMPT,
    };
    use std::env;
    use std::fs;
    use std::path::PathBuf;
    use std::time::{SystemTime, UNIX_EPOCH};

    fn temp_path(label: &str) -> PathBuf {
        let nanos = SystemTime::now()
            .duration_since(UNIX_EPOCH)
            .expect("time")
            .as_nanos();
        std::env::temp_dir().join(format!("xbp-config-{}-{}.yaml", label, nanos))
    }

    #[test]
    fn versioning_registry_defaults_include_core_files() {
        let defaults = default_versioning_files();
        assert!(defaults.contains(&"README.md".to_string()));
        assert!(defaults.contains(&"Cargo.toml".to_string()));
        assert!(defaults.contains(&".xbp/xbp.yaml".to_string()));
    }

    #[test]
    fn versioning_registry_default_config_populates_files() {
        let config = VersioningFilesConfig::default();
        assert!(!config.files.is_empty());
    }

    #[test]
    fn versioning_registry_defaults_do_not_contain_duplicates() {
        let defaults = default_versioning_files();
        let mut deduped = defaults.clone();
        deduped.sort();
        deduped.dedup();
        assert_eq!(defaults.len(), deduped.len());
    }

    #[test]
    fn syncing_registry_creates_file_with_defaults() {
        let path = temp_path("defaults");
        sync_versioning_files_registry_at(&path).expect("sync");

        let content = fs::read_to_string(&path).expect("read");
        assert!(content.contains("README.md"));
        assert!(content.contains("Cargo.toml"));

        let _ = fs::remove_file(path);
    }

    #[test]
    fn syncing_registry_preserves_user_added_entries() {
        let path = temp_path("preserve");
        fs::write(&path, "files:\n  - custom.file\n").expect("write registry");

        sync_versioning_files_registry_at(&path).expect("sync");

        let content = fs::read_to_string(&path).expect("read");
        assert!(content.contains("custom.file"));
        assert!(content.contains("README.md"));

        let _ = fs::remove_file(path);
    }

    #[test]
    fn api_config_normalizes_trailing_slashes() {
        assert_eq!(
            ApiConfig::normalize_base_url("https://api.xbp.app///"),
            "https://api.xbp.app".to_string()
        );
    }

    #[test]
    fn api_config_uses_default_for_blank_values() {
        assert_eq!(
            ApiConfig::normalize_base_url("   "),
            "https://api.xbp.app".to_string()
        );
    }

    #[test]
    fn api_config_builds_version_endpoints() {
        let config = ApiConfig {
            base_url: "https://api.test.xbp".to_string(),
        };
        let endpoint = config.version_endpoint("demo");
        let increment = config.increment_endpoint();

        assert_eq!(endpoint, "https://api.test.xbp/version?project_name=demo");
        assert_eq!(increment, "https://api.test.xbp/version/increment");
    }

    #[test]
    fn api_config_exposes_cli_projects_register_endpoint() {
        let config = ApiConfig {
            base_url: "https://api.xbp.app".to_string(),
        };
        assert_eq!(
            config.cli_projects_register_endpoint(),
            "https://xbp.app/api/cli/projects/register"
        );
    }

    #[test]
    fn api_config_derives_browser_base_url_from_api_subdomain() {
        assert_eq!(
            ApiConfig::derive_web_base_url("https://api.xbp.app"),
            "https://xbp.app".to_string()
        );
        assert_eq!(
            ApiConfig::derive_web_base_url("https://api.eu-de2.xbp.app"),
            "https://xbp.app".to_string()
        );
        assert_eq!(
            ApiConfig::derive_web_base_url("https://api.staging.xbp.app"),
            "https://xbp.app".to_string()
        );
        assert_eq!(
            ApiConfig::derive_web_base_url("https://api.internal.example.com"),
            "https://internal.example.com".to_string()
        );
        assert_eq!(
            ApiConfig::derive_web_base_url("http://localhost:3000"),
            "http://localhost:3000".to_string()
        );
    }

    #[test]
    fn package_lookup_defaults_include_npm_and_crates() {
        let defaults = default_package_name_lookups();
        assert!(defaults.iter().any(|entry| {
            entry.file == "package.json" && entry.registry == "npm" && entry.key == "name"
        }));
        assert!(defaults.iter().any(|entry| {
            entry.file == "Cargo.toml"
                && entry.registry == "crates.io"
                && entry.key == "package.name"
        }));
    }

    #[test]
    fn package_lookup_default_config_populates_entries() {
        let config = PackageNameFilesConfig::default();
        assert!(!config.lookups.is_empty());
    }

    #[test]
    fn syncing_package_lookup_registry_creates_defaults() {
        let path = temp_path("package-lookup-defaults");
        sync_package_name_files_registry_at(&path).expect("sync");

        let content = fs::read_to_string(&path).expect("read");
        assert!(content.contains("package.json"));
        assert!(content.contains("Cargo.toml"));

        let _ = fs::remove_file(path);
    }

    #[test]
    fn syncing_package_lookup_registry_preserves_custom_entries() {
        let path = temp_path("package-lookup-custom");
        fs::write(
            &path,
            "lookups:\n  - file: custom.yaml\n    format: yaml\n    key: app.name\n    registry: npm\n",
        )
        .expect("write package lookup registry");

        sync_package_name_files_registry_at(&path).expect("sync");
        let content = fs::read_to_string(&path).expect("read");
        assert!(content.contains("custom.yaml"));
        assert!(content.contains("package.json"));

        let _ = fs::remove_file(path);
    }

    #[test]
    fn secret_provider_parses_supported_keys() {
        assert_eq!(
            SecretProvider::from_key("openrouter"),
            Some(SecretProvider::OpenRouter)
        );
        assert_eq!(
            SecretProvider::from_key("github"),
            Some(SecretProvider::Github)
        );
        assert_eq!(
            SecretProvider::from_key("linear"),
            Some(SecretProvider::Linear)
        );
        assert_eq!(SecretProvider::from_key("npm"), Some(SecretProvider::Npm));
        assert_eq!(
            SecretProvider::from_key("crates"),
            Some(SecretProvider::Crates)
        );
        assert_eq!(SecretProvider::from_key("unknown"), None);
    }

    #[test]
    fn ssh_config_secret_get_set_roundtrip() {
        let mut cfg = SshConfig::new();
        cfg.set_secret(SecretProvider::OpenRouter, Some("or-test-123".to_string()));
        cfg.set_secret(SecretProvider::Github, Some("gho_test_456".to_string()));
        cfg.set_secret(SecretProvider::Linear, Some("lin_api_test_789".to_string()));
        cfg.set_secret(SecretProvider::Npm, Some("npm_test_token".to_string()));
        cfg.set_secret(SecretProvider::Crates, Some("crate_test_token".to_string()));

        assert_eq!(
            cfg.get_secret(SecretProvider::OpenRouter),
            Some("or-test-123")
        );
        assert_eq!(cfg.get_secret(SecretProvider::Github), Some("gho_test_456"));
        assert_eq!(
            cfg.get_secret(SecretProvider::Linear),
            Some("lin_api_test_789")
        );
        assert_eq!(cfg.get_secret(SecretProvider::Npm), Some("npm_test_token"));
        assert_eq!(
            cfg.get_secret(SecretProvider::Crates),
            Some("crate_test_token")
        );
        assert!(cfg.get_secret_metadata(SecretProvider::Npm).is_some());
    }

    #[test]
    fn default_openrouter_config_populates_models_and_prompts() {
        let config = OpenRouterConfig::default();

        assert_eq!(config.commit_model, DEFAULT_MODEL);
        assert_eq!(config.release_notes_model, DEFAULT_MODEL);
        assert_eq!(
            config.commit_system_prompt,
            DEFAULT_COMMIT_SYSTEM_PROMPT.to_string()
        );
        assert_eq!(
            config.release_notes_system_prompt,
            DEFAULT_RELEASE_NOTES_SYSTEM_PROMPT.to_string()
        );
    }

    #[test]
    fn default_ssh_config_serialization_includes_openrouter_generation_settings() {
        let yaml = serde_yaml::to_string(&SshConfig::new()).expect("serialize default config");

        assert!(yaml.contains("openrouter:"));
        assert!(yaml.contains("commit_model: openai/gpt-4o-mini"));
        assert!(yaml.contains("release_notes_model: openai/gpt-4o-mini"));
        assert!(yaml.contains("commit_system_prompt"));
        assert!(yaml.contains("release_notes_system_prompt"));
    }

    #[test]
    fn ssh_config_new_uses_openrouter_defaults() {
        let config = SshConfig::new();

        assert_eq!(config.openrouter.commit_model, DEFAULT_MODEL);
        assert_eq!(config.openrouter.release_notes_model, DEFAULT_MODEL);
        assert_eq!(
            config.openrouter.commit_system_prompt,
            DEFAULT_COMMIT_SYSTEM_PROMPT.to_string()
        );
        assert_eq!(
            config.openrouter.release_notes_system_prompt,
            DEFAULT_RELEASE_NOTES_SYSTEM_PROMPT.to_string()
        );
    }

    #[test]
    fn syncing_global_config_backfills_openrouter_generation_defaults() {
        let path = temp_path("global-config");
        fs::write(
            &path,
            "password: null\nusername: null\nhost: null\nproject_dir: null\nxbp_api_token: null\nopenrouter_api_key: null\ngithub_oauth2_key: null\ncloudflare_api_token: null\ncloudflare_account_id: null\nlinear_api_key: null\nnpm_token: null\ncrates_token: null\nlinear: null\ncli_auth: null\nsecret_metadata: {}\n",
        )
        .expect("write config");

        sync_global_config_defaults_at(&path).expect("sync config defaults");

        let content = fs::read_to_string(&path).expect("read config");
        assert!(content.contains("openrouter:"));
        assert!(content.contains("commit_model: openai/gpt-4o-mini"));
        assert!(content.contains("release_notes_model: openai/gpt-4o-mini"));
        assert!(content.contains("commit_system_prompt"));
        assert!(content.contains("release_notes_system_prompt"));

        let _ = fs::remove_file(path);
    }

    #[test]
    fn resolve_secret_prefers_environment_value() {
        std::env::set_var("OPENROUTER_API_KEY", "env-openrouter");
        std::env::set_var("GITHUB_TOKEN", "env-github");
        std::env::set_var("XBP_API_TOKEN", "env-xbp");

        assert_eq!(
            resolve_openrouter_api_key(),
            Some("env-openrouter".to_string())
        );
        assert_eq!(resolve_github_oauth2_key(), Some("env-github".to_string()));
        assert_eq!(resolve_xbp_api_token(), Some("env-xbp".to_string()));

        std::env::remove_var("OPENROUTER_API_KEY");
        std::env::remove_var("GITHUB_TOKEN");
        std::env::remove_var("XBP_API_TOKEN");
    }

    #[test]
    fn resolve_cloudflare_account_id_reads_project_env_files() {
        use crate::utils::CLOUDFLARE_ACCOUNT_ID_ENV_KEYS;

        let dir = temp_path("cf-account-env");
        fs::create_dir_all(dir.join(".xbp")).expect("mkdir");
        fs::write(dir.join(".xbp/xbp.yaml"), "project_name: demo\n").expect("write xbp");
        fs::write(
            dir.join(".env"),
            "XBP_CLOUDFLARE_ACCOUNT_ID=acc-from-project-env\n",
        )
        .expect("write env");

        let previous = env::current_dir().expect("cwd");
        env::set_current_dir(&dir).expect("chdir");
        for key in CLOUDFLARE_ACCOUNT_ID_ENV_KEYS {
            env::remove_var(key);
        }

        assert_eq!(
            cloudflare_account_id_from_project_env().as_deref(),
            Some("acc-from-project-env")
        );
        assert_eq!(
            resolve_cloudflare_account_id().as_deref(),
            Some("acc-from-project-env")
        );

        env::set_current_dir(previous).expect("restore cwd");
        let _ = fs::remove_dir_all(dir);
    }
}