Stage 00: Terraform Infrastructure

1. validate_prerequisites    Check terraform, az, jq are installed
2. register_providers        Register required Azure resource providers
3. setup_backend             Ensure TF state storage account exists
4. initialize                terraform init with backend config
5. import_existing           Import pre-existing resources into state
6. sync_state                terraform refresh to detect drift
7. plan_changes              terraform plan to generate execution plan
8. apply_changes             terraform apply if changes detected
9. export_outputs            Cache outputs for downstream stages

require_command terraform "Install Terraform from https://terraform.io"
require_command az "Install Azure CLI from https://aka.ms/installazurecli"
require_command jq "Install jq: brew install jq"

if [[ -n "${ARM_CLIENT_ID:-}" ]]; then
    az login --service-principal \
        --username "$ARM_CLIENT_ID" \
        --password "$ARM_CLIENT_SECRET" \
        --tenant "$ARM_TENANT_ID"
fi

TERRAFORM_DIR="${MATIH_ROOT}/infrastructure/terraform/environments/azure-matihlabs"
RESOURCE_GROUP="matihplatformrg"
AKS_CLUSTER="matihlabsaks"
TF_STATE_STORAGE_ACCOUNT="matihlabstfstate"
TF_STATE_CONTAINER="tfstate"
TF_STATE_KEY="matih-platform.tfstate"
AZURE_LOCATION="centralindia"

terraform -chdir="$TERRAFORM_DIR" output -json > "$TF_OUTPUTS_FILE"

ACR_NAME=$(tf_get_output "acr_name" "matihlabsacr")
AKS_CLUSTER_NAME=$(tf_get_output "aks_cluster_name" "matihlabsaks")