# Provisioning Platform Default Configuration
# This file defines defaults for all provisioning system configuration

# Documentation Configuration
[documentation]
# mdBook base URL for hosted documentation
# Set to empty string ("") to use local files only (default)
# Set to a URL when mdBook is hosted (e.g., "https://docs.provisioning.local")
mdbook_base_url = ""

# Enable mdBook URL resolution
# When true and mdbook_base_url is set, CLI will show documentation URLs
# When false or mdbook_base_url empty, uses local files only
mdbook_enabled = false

# Local documentation paths (relative to provisioning root)
docs_root = "docs/src"
guides_path = "docs/src/guides"
api_reference_path = "docs/src/api-reference"
architecture_path = "docs/src/architecture"

# Help System Configuration
[help]
# Help system language/locale
# Options: "en-US", "es-ES", or other supported locales
# Falls back to English if locale not available
locale = "en-US"

# Use internationalized help (Fluent-based)
# When true: Uses help_system_fluent.nu with translations
# When false: Uses help_system.nu with English-only help
use_fluent = false

# Logging Configuration
[logging]
# Minimum log level: "off", "error", "warn", "info", "debug", "trace"
level = "info"

# Log output format: "text" or "json"
format = "text"

# Cache Configuration
[cache]
# Enable caching of parsed configurations
enabled = true

# Cache directory (relative to provisioning root)
dir = ".cache/provisioning"

# Cache TTL in seconds (0 = no expiration)
ttl = 3600

# Performance Configuration
[performance]
# Maximum parallel operations
max_parallel = 4

# Operation timeout in seconds
timeout = 300

# Network Configuration
[network]
# HTTP/REST service port
http_port = 8080

# MCP server port
mcp_port = 8081

# Orchestrator service port
orchestrator_port = 5000

# Security Configuration
[security]
# Enable strict mode (enforces all security checks)
strict_mode = false

# TLS/SSL for service communication
enable_tls = false

# Certificate paths (required if enable_tls = true)
cert_path = ""
key_path = ""

# Configuration Notes
#
# 1. User Configuration Override
#    Users can override these defaults by creating:
#    ~/.config/provisioning/user_config.toml
#
# 2. Environment Variables
#    Can override any setting with: PROVISIONING_<SECTION>_<KEY>
#    Example: PROVISIONING_DOCUMENTATION_MDBOOK_BASE_URL="https://docs.example.com"
#
# 3. Workspace Configuration
#    Workspace-specific config in: workspace/config/provisioning-config.toml
#
# 4. Loading Hierarchy
#    1. CLI arguments (highest priority)
#    2. Environment variables
#    3. User config (~/.config/provisioning/user_config.toml)
#    4. Workspace config (workspace/config/provisioning-config.toml)
#    5. This file (lowest priority)
