[SSOT Phase 1] Foundation - Create SSOT Config Loaders

[mrveiss]

Parent Issue

Part of #599 - Implement Single Source of Truth Configuration System

Phase 1: Foundation

Objective: Create new SSOT infrastructure without breaking existing code.

Tasks

• Create src/config/ssot_config.py with Pydantic models
  • VMConfig, PortConfig, LLMConfig, TimeoutConfig, FeatureConfig
  • AutoBotConfig master class with computed URL properties
  • get_config() singleton accessor
• Create autobot-vue/src/config/ssot-config.ts with TypeScript interfaces
  • Mirror Python config structure
  • Environment variable helpers (getEnv, getEnvNumber, getEnvBoolean)
  • Singleton config with computed URLs
• Create scripts/sync-env.sh for environment synchronization
  • Map AUTOBOT_* variables to VITE_* for frontend
  • Auto-generate autobot-vue/.env from master .env
• Update .env.example with new canonical SSOT structure
  • AUTOBOT_VM_* for all VM IPs
  • AUTOBOT_PORT_* for all service ports
  • AUTOBOT_LLM_* for LLM configuration
  • AUTOBOT_TIMEOUT_* for all timeouts
  • AUTOBOT_FEATURE_* for feature flags
• Add validation tests for both loaders

Files to Create

/home/kali/Desktop/AutoBot/
├── src/config/ssot_config.py           # NEW
├── autobot-vue/src/config/ssot-config.ts  # NEW
├── scripts/sync-env.sh                 # NEW
└── .env.example                        # UPDATE

Acceptance Criteria

• Python loader reads from .env and provides typed access
• TypeScript loader reads from Vite env and provides typed access
• sync-env.sh successfully generates frontend .env from master
• Both loaders have fallback defaults for development
• Existing code continues to work (backward compatibility)
• Unit tests pass for both loaders

Reference

See architecture document: docs/architecture/SSOT_CONFIGURATION_ARCHITECTURE.md

• Section 3.3: Python Loader Implementation
• Section 3.4: TypeScript Loader Implementation
• Section 3.5: Environment File Synchronization

Labels

• refactoring
• architecture

[mrveiss]

Starting work on Phase 1: Foundation - Create SSOT Config Loaders

Tasks to complete:

1. Create src/config/ssot_config.py with Pydantic models
2. Create autobot-vue/src/config/ssot-config.ts with TypeScript interfaces
3. Create scripts/sync-env.sh for environment synchronization
4. Update .env.example with new canonical SSOT structure
5. Add validation tests for both loaders

[mrveiss]

Completed ✅

Changes Made:

Python Loader (src/config/ssot_config.py):

• Pydantic BaseSettings with nested config classes (VMConfig, PortConfig, LLMConfig, TimeoutConfig, RedisConfig, FeatureConfig)
• Singleton pattern via @lru_cache for get_config()
• Computed URL properties for backward compatibility
• Reads from master .env file with AUTOBOT_ prefix

TypeScript Loader (autobot-vue/src/config/ssot-config.ts):

• Matching interfaces for Python config classes
• Helper functions: getEnv, getEnvNumber, getEnvBoolean
• Singleton pattern with cached config instance
• Computed URL getters for all services
• Reads from Vite environment variables (VITE_* prefix)

Environment Sync Script (scripts/sync-env.sh):

• Maps AUTOBOT_* variables to VITE_* for frontend
• Supports --check and --force modes
• Smart timestamp comparison for incremental updates
• 59 variable mappings implemented

Tests:

• 27 Python unit tests (tests/unit/test_ssot_config.py) - all passing
• TypeScript type validation tests (autobot-vue/tests/unit/ssot-config.spec.ts)

Updated .env.example with canonical SSOT structure and documentation.

Acceptance Criteria Verified:

• Python SSOT config loader created with Pydantic models
• TypeScript SSOT config loader created with interfaces
• sync-env.sh script creates frontend .env from master .env
• .env.example updated with canonical SSOT structure
• All 27 Python tests pass
• TypeScript types validate correctly
• Code review passed (8.5/10 rating)

Commits:

• 025e5e2: feat(config): Implement SSOT configuration loaders ([SSOT Phase 1] Foundation - Create SSOT Config Loaders #601)