v5.2.0

Added

• Added ordered per-workload deploys with repeatable cpflow deploy-image -w/--workload filtering and optional deploy_order groups in controlplane.yml. PR 397 by Justin Gordon. Fixes issue 396. cpflow deploy-image can now deploy selected app workloads, and production promotion inherits deploy_order so workloads such as a Node renderer can roll out and become ready before Rails.
• Added generic telemetry documentation for deploying an OpenTelemetry Collector with Control Plane Flow, including collector workload templates, application instrumentation, telemetry pipelines, review-app isolation, and troubleshooting guidance. PR 369 by Justin Gordon.
• Added a Rails-focused Grafana and OpenTelemetry guide for building Control Plane dashboards from generated span and log metrics, including collector workload guidance, spanmetrics setup, rollout order, alerting, and validation checklists. PR 352 by Justin Gordon.

Changed

• Removed the generated pre_deletion: rails db:drop example from controlplane.yml so new configurations do not encourage teardown that can fail while app workloads still hold database connections. PR 348 by Justin Gordon.
• Updated the generated GitHub Actions help and AI rollout prompt to recommend Capacity AI for idle standard workloads and clarify the separate serverless scale-to-zero path. PR 364 by Justin Gordon.
• Updated cpflow ai-github-flow-prompt so rollout agents install a missing cpflow gem or clearly report the installation blocker. PR 371 by Justin Gordon.

Fixed

• Fixed doctor and setup-app template validation to inspect only configured setup_app_templates, avoiding duplicate-resource errors from unused alternative templates while preserving the all-template fallback. PR 363 by Justin Gordon.
• Fixed generated review-app deploy workflows so they wait for workload readiness and an accepted HTTP response before marking a GitHub deployment successful. PR 363 by Justin Gordon.
• Fixed cpflow crashing at load time with invalid byte sequence in US-ASCII (ArgumentError) on systems without a UTF-8 locale. PR 404 by Justin Gordon. Command::Base.all_commands now reads command files with an explicit UTF-8 encoding instead of relying on Encoding.default_external. Fixes issue 372.