Implement core command infrastructure and build command logic

[jeffreyaven]

Summary

This PR implements the core infrastructure for stackql-deploy commands, including a new CommandRunner base class that encapsulates shared resource processing logic, along with comprehensive implementations of configuration, templating, utilities, and environment handling modules. The build command is refactored to use this new infrastructure.

Key Changes

Core Infrastructure

• New src/commands/base.rs: Introduces CommandRunner struct that serves as the Rust equivalent of Python's StackQLBase class. Handles:

  • Client and template engine initialization
  • Manifest loading and provider pulling
  • Global context rendering
  • Resource processing with full context resolution
  • Query execution and result handling
  • Export variable management

• New src/core/config.rs: Configuration module for:

  • Rendering global variables from manifest and environment
  • Building full template context for resources
  • SQL-compatible value conversion
  • Resource type resolution

• New src/core/utils.rs: Low-level utility functions including:

  • StackQL query execution with retry logic
  • Error handling and exit procedures
  • Provider pulling and management
  • External script execution
  • Export variable handling
  • Query result processing

• New src/core/templating.rs: Query template handling:

  • Loading and parsing .iql files
  • Query option parsing (retries, delays, etc.)
  • Template rendering with context

• New src/core/env.rs: Environment variable management:

  • Loading from .env files
  • CLI override support

Command Updates

• src/commands/build.rs: Refactored to use CommandRunner infrastructure with full resource deployment logic
• src/commands/teardown.rs: Updated with new command structure
• src/commands/test.rs: Updated with new command structure
• src/commands/mod.rs: Added base module export

Template Engine Enhancements

• src/template/engine.rs: Extended with additional rendering capabilities
• src/template/context.rs: Enhanced context management

Documentation

• Comprehensive website documentation added via Docusaurus including:
  • Getting started guide
  • Manifest file specification
  • Resource query files documentation
  • Template filters reference
  • CLI command references (build, teardown, test, init, etc.)
  • Template library examples (AWS VPC/EC2, Azure VNet/VM, Kubernetes the Hard Way)
  • GitHub Actions integration guide

Build & Configuration

• Updated Cargo.toml with additional dependencies
• Updated CI workflow from "Build" to "CI"
• Added website configuration and theme customization

Implementation Details

• The CommandRunner follows a builder pattern for initialization, loading all necessary components (manifest, environment, providers) in sequence
• Retry logic with exponential backoff is implemented for resilient query execution
• Template rendering supports Jinja-like syntax with variable substitution
• Export handling allows resources to pass values to subsequent resources in the deployment chain
• Error handling uses structured logging with graceful exit procedures

https://claude.ai/code/session_01ShAyjRLWBYC3tPsusCxggv