cpflow 4.2.0 → 5.0.0.rc.1

data/script/check_command_docs

@@ -1,3 +1,5 @@
-#!/bin/sh
+#!/usr/bin/env bash
+set -euo pipefail
+
 bundle exec rake update_command_docs
-git diff --exit-code || exit 1
+git diff --exit-code -- docs/commands.md

data/script/check_cpln_links

@@ -1,31 +1,45 @@
 #!/usr/bin/env bash
 
+set -euo pipefail
+
 bad_links=("controlplane.com/shakacode" "https://docs.controlplane.com")
 proper_links=("shakacode.controlplane.com" "https://shakadocs.controlplane.com")
 
-bold=$(tput bold)
-normal=$(tput sgr0)
+bold=$(tput bold 2>/dev/null || true)
+normal=$(tput sgr0 2>/dev/null || true)
+
+files=()
+if [ "$#" -gt 0 ]; then
+    for file in "$@"; do
+        if [[ "$file" == *.md ]] && [ -f "$file" ]; then
+            files+=("$file")
+        fi
+    done
+else
+    while IFS= read -r file; do
+        files+=("$file")
+    done < <(git ls-files -- '*.md' ':!:script/check_cpln_links')
+fi
+
+if [ "${#files[@]}" -eq 0 ]; then
+    echo "No markdown files to validate."
+    exit 0
+fi
 
 exit_status=0
 accumulated_results=""
 seen_bad_links_indexes=()
 
 for ((idx = 0; idx < ${#bad_links[@]}; idx++)); do
-    results=$(git grep \
-        --recursive \
+    if results=$(git grep \
         --line-number \
         --fixed-strings \
         --break \
         --heading \
         --color=always -- \
         "${bad_links[idx]}" \
-        ':!script/check_cpln_links' '*.md')
-
-    # Line would become really unwieldly if everything was mushed into the
-    # conditional, so let's ignore this check here.
-    # shellcheck disable=SC2181
-    if [ $? -eq 0 ]; then
-        accumulated_results+="$results"
+        -- "${files[@]}"); then
+        accumulated_results+="$results"$'\n'
         seen_bad_links_indexes+=("$idx")
         exit_status=1
     fi

data/script/precommit/check_command_docs

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+context="${1:-staged}"
+pattern='^(lib/command/.*\.rb|docs/commands\.md|script/update_command_docs|script/check_command_docs|script/precommit/check_command_docs|Rakefile)$'
+relevant_files=()
+changed_files_output="$(./script/precommit/get_changed_files "$context" "$pattern")" || {
+    echo "Error: failed to determine command-doc related files." >&2
+    exit 1
+}
+while IFS= read -r f; do
+    [ -n "$f" ] && relevant_files+=("$f")
+done <<< "$changed_files_output"
+
+if [ "${#relevant_files[@]}" -eq 0 ]; then
+    echo "No command-doc related files changed; skipping command docs check."
+    exit 0
+fi
+
+echo "Running command docs consistency check."
+bundle exec rake check_command_docs

data/script/precommit/check_cpln_links

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+context="${1:-staged}"
+markdown_files=()
+changed_files_output="$(./script/precommit/get_changed_files "$context" '\.md$')" || {
+    echo "Error: failed to determine changed markdown files." >&2
+    exit 1
+}
+while IFS= read -r f; do
+    [ -n "$f" ] && markdown_files+=("$f")
+done <<< "$changed_files_output"
+
+if [ "${#markdown_files[@]}" -eq 0 ]; then
+    echo "No markdown files changed; skipping Control Plane link check."
+    exit 0
+fi
+
+echo "Checking Control Plane links in changed markdown files."
+./script/check_cpln_links "${markdown_files[@]}"

data/script/precommit/check_trailing_newlines

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+context="${1:-staged}"
+files=()
+changed_files_output="$(./script/precommit/get_changed_files "$context" '.*')" || {
+    echo "Error: failed to determine changed files." >&2
+    exit 1
+}
+while IFS= read -r f; do
+    [ -n "$f" ] && files+=("$f")
+done <<< "$changed_files_output"
+
+if [ "${#files[@]}" -eq 0 ]; then
+    echo "No files to check for trailing newlines."
+    exit 0
+fi
+
+# Identify files that need a trailing newline.
+needs_fix=()
+for file in "${files[@]}"; do
+    [ -f "$file" ] || continue
+
+    # Skip binary files based on staged content.
+    if ! git cat-file blob ":$file" 2>/dev/null | grep -Iq .; then
+        continue
+    fi
+
+    # Inspect staged content so partial staging is handled correctly.
+    staged_last_byte=""
+    if ! staged_last_byte="$(git cat-file blob ":$file" 2>/dev/null | tail -c 1)"; then
+        continue
+    fi
+
+    if [ -n "$staged_last_byte" ]; then
+        needs_fix+=("$file")
+    fi
+done
+
+if [ "${#needs_fix[@]}" -gt 0 ]; then
+    # Stash unstaged changes BEFORE modifying files so --keep-index preserves
+    # the working tree state and our modifications are not undone.
+    has_stash=false
+    if ! git diff --quiet -- "${needs_fix[@]}"; then
+        git stash push --keep-index --quiet -m "precommit: trailing newlines unstaged changes"
+        has_stash=true
+    fi
+
+    restore_stash() {
+        if [ "$has_stash" = true ]; then
+            if ! git stash pop; then
+                echo "Warning: Could not restore unstaged changes from stash. Run 'git stash pop' manually to recover." >&2
+            fi
+        fi
+    }
+
+    trap restore_stash EXIT
+
+    for file in "${needs_fix[@]}"; do
+        echo "Adding trailing newline: $file"
+        printf '\n' >> "$file"
+    done
+
+    git add -- "${needs_fix[@]}"
+fi
+
+echo "Trailing newline check complete."

data/script/precommit/get_changed_files

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+context="${1:-staged}"
+pattern="${2:-.*}"
+base_ref="${3:-origin/main}"
+
+# Filter lines matching pattern. Exit 0 on no matches (grep exit 1),
+# but propagate real errors (exit >= 2).
+filter_matches() {
+    grep -E -- "$pattern" || {
+        local status=$?
+        if [ "$status" -eq 1 ]; then
+            return 0
+        fi
+        return "$status"
+    }
+}
+
+case "$context" in
+    staged)
+        git diff --cached --name-only --diff-filter=ACMR | filter_matches
+        ;;
+    all-changed)
+        (
+            git diff --cached --name-only --diff-filter=ACMR
+            git diff --name-only --diff-filter=ACMR
+            git ls-files --others --exclude-standard
+        ) | sort -u | filter_matches
+        ;;
+    branch)
+        if ! git rev-parse --verify --quiet "$base_ref" >/dev/null; then
+            fetch_hint="git fetch --all --prune"
+            if [[ "$base_ref" == */* ]]; then
+                remote="${base_ref%%/*}"
+                ref="${base_ref#*/}"
+                fetch_hint="git fetch ${remote} ${ref}"
+            fi
+            echo "Error: ${base_ref} not found. Run: ${fetch_hint}" >&2
+            exit 1
+        fi
+        git diff --name-only --diff-filter=ACMR "$base_ref"...HEAD | filter_matches
+        ;;
+    *)
+        echo "Usage: $0 {staged|all-changed|branch} [pattern] [base_ref]" >&2
+        exit 1
+        ;;
+esac

data/script/precommit/ruby_autofix

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+context="${1:-staged}"
+files=()
+changed_files_output="$(./script/precommit/get_changed_files "$context" '\.(rb|rake|ru)$')" || {
+    echo "Error: failed to determine changed Ruby files." >&2
+    exit 1
+}
+while IFS= read -r f; do
+    [ -n "$f" ] && files+=("$f")
+done <<< "$changed_files_output"
+
+if [ "${#files[@]}" -eq 0 ]; then
+    echo "No Ruby files to auto-fix."
+    exit 0
+fi
+
+echo "Running RuboCop auto-fix on changed Ruby files:"
+printf "  %s\n" "${files[@]}"
+
+# Stash unstaged changes so auto-fix only touches what was staged.
+# This preserves partial staging (git add -p).
+has_stash=false
+if ! git diff --quiet -- "${files[@]}"; then
+    git stash push --keep-index --quiet -m "precommit: ruby_autofix unstaged changes"
+    has_stash=true
+fi
+
+restore_stash() {
+    if [ "$has_stash" = true ]; then
+        if ! git stash pop; then
+            echo "Warning: Could not restore unstaged changes from stash. Run 'git stash pop' manually to recover." >&2
+        fi
+    fi
+}
+
+trap restore_stash EXIT
+
+rubocop_exit=0
+bundle exec rubocop -A --force-exclusion -- "${files[@]}" || rubocop_exit=$?
+
+# Re-stage auto-corrected files regardless of rubocop exit code so fixable
+# changes are not lost when non-fixable offenses still fail the hook.
+git add -- "${files[@]}"
+
+if [ "$rubocop_exit" -ne 0 ]; then
+    exit "$rubocop_exit"
+fi
+
+echo "Ruby auto-fix complete."

data/script/precommit/ruby_lint

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+context="${1:-staged}"
+files=()
+changed_files_output="$(./script/precommit/get_changed_files "$context" '\.(rb|rake|ru)$')" || {
+    echo "Error: failed to determine changed Ruby files." >&2
+    exit 1
+}
+while IFS= read -r f; do
+    [ -n "$f" ] && files+=("$f")
+done <<< "$changed_files_output"
+
+if [ "${#files[@]}" -eq 0 ]; then
+    echo "No Ruby files to lint."
+    exit 0
+fi
+
+echo "Running RuboCop lint on changed Ruby files:"
+printf "  %s\n" "${files[@]}"
+
+if ! bundle exec rubocop --force-exclusion --display-cop-names -- "${files[@]}"; then
+    echo ""
+    echo "RuboCop lint failed."
+    rubocop_autofix_hint=""
+    printf -v rubocop_autofix_hint "%q " "${files[@]}"
+    echo "Try: bundle exec rubocop -A --force-exclusion -- ${rubocop_autofix_hint% }"
+    echo "Skip hooks only if necessary: git commit --no-verify"
+    exit 1
+fi
+
+echo "Ruby lint complete."

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cpflow
 version: !ruby/object:Gem::Version
-  version: 4.2.0
+  version: 5.0.0.rc.1
 platform: ruby
 authors:
 - Justin Gordon
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-20 00:00:00.000000000 Z
+date: 2026-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dotenv
@@ -17,56 +17,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.8.1
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.8.1
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: jwt
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.8.1
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.8.1
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: psych
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.1.0
+        version: '5.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.1.0
+        version: '5.2'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.2.1
+        version: '1.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.2.1
+        version: '1.4'
 description: CLI for providing Heroku-like platform-as-a-service on Control Plane
 email:
 - justin@shakacode.com
@@ -76,6 +76,9 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".agents/workflows/address-review.md"
+- ".claude/commands/address-review.md"
+- ".claude/commands/update-changelog.md"
 - ".github/workflows/check_cpln_links.yml"
 - ".github/workflows/claude-code-review.yml"
 - ".github/workflows/claude.yml"
@@ -99,6 +102,7 @@ files:
 - bin/cpflow
 - cpflow
 - cpflow.gemspec
+- docs/ai-github-flow-prompt.md
 - docs/assets/grafana-alert.png
 - docs/assets/memcached.png
 - docs/assets/sidekiq-pre-stop-hook.png
@@ -108,6 +112,7 @@ files:
 - docs/migrating-heroku-to-control-plane.md
 - docs/postgres.md
 - docs/redis.md
+- docs/releasing.md
 - docs/secrets-and-env-values.md
 - docs/terraform/details.md
 - docs/terraform/example/.controlplane/controlplane.yml
@@ -119,6 +124,7 @@ files:
 - docs/troubleshooting.md
 - examples/circleci.yml
 - examples/controlplane.yml
+- lib/command/ai_github_flow_prompt.rb
 - lib/command/apply_template.rb
 - lib/command/base.rb
 - lib/command/base_sub_command.rb
@@ -133,6 +139,9 @@ files:
 - lib/command/env.rb
 - lib/command/exists.rb
 - lib/command/generate.rb
+- lib/command/generate_github_actions.rb
+- lib/command/generator_helpers.rb
+- lib/command/github_flow_readiness.rb
 - lib/command/info.rb
 - lib/command/latest_image.rb
 - lib/command/logs.rb
@@ -162,8 +171,11 @@ files:
 - lib/core/controlplane_api.rb
 - lib/core/controlplane_api_direct.rb
 - lib/core/doctor_service.rb
+- lib/core/github_flow_readiness/checks.rb
+- lib/core/github_flow_readiness_service.rb
 - lib/core/helpers.rb
 - lib/core/maintenance_mode.rb
+- lib/core/repo_introspection.rb
 - lib/core/shell.rb
 - lib/core/template_parser.rb
 - lib/core/terraform_config/agent.rb
@@ -189,9 +201,31 @@ files:
 - lib/generator_templates/Dockerfile
 - lib/generator_templates/controlplane.yml
 - lib/generator_templates/entrypoint.sh
+- lib/generator_templates/release_script.sh
 - lib/generator_templates/templates/app.yml
 - lib/generator_templates/templates/postgres.yml
 - lib/generator_templates/templates/rails.yml
+- lib/generator_templates_sqlite/controlplane.yml
+- lib/generator_templates_sqlite/release_script.sh
+- lib/generator_templates_sqlite/templates/app.yml
+- lib/generator_templates_sqlite/templates/db.yml
+- lib/generator_templates_sqlite/templates/rails.yml
+- lib/generator_templates_sqlite/templates/storage.yml
+- lib/github_flow_templates/.github/actions/cpflow-build-docker-image/action.yml
+- lib/github_flow_templates/.github/actions/cpflow-delete-control-plane-app/action.yml
+- lib/github_flow_templates/.github/actions/cpflow-delete-control-plane-app/delete-app.sh
+- lib/github_flow_templates/.github/actions/cpflow-detect-release-phase/action.yml
+- lib/github_flow_templates/.github/actions/cpflow-setup-environment/action.yml
+- lib/github_flow_templates/.github/actions/cpflow-validate-config/action.yml
+- lib/github_flow_templates/.github/actions/cpflow-wait-for-health/action.yml
+- lib/github_flow_templates/.github/cpflow-help.md
+- lib/github_flow_templates/.github/workflows/cpflow-cleanup-stale-review-apps.yml
+- lib/github_flow_templates/.github/workflows/cpflow-delete-review-app.yml
+- lib/github_flow_templates/.github/workflows/cpflow-deploy-review-app.yml
+- lib/github_flow_templates/.github/workflows/cpflow-deploy-staging.yml
+- lib/github_flow_templates/.github/workflows/cpflow-help-command.yml
+- lib/github_flow_templates/.github/workflows/cpflow-promote-staging-to-production.yml
+- lib/github_flow_templates/.github/workflows/cpflow-review-app-help.yml
 - lib/patches/array.rb
 - lib/patches/hash.rb
 - lib/patches/string.rb
@@ -200,6 +234,12 @@ files:
 - script/add_command
 - script/check_command_docs
 - script/check_cpln_links
+- script/precommit/check_command_docs
+- script/precommit/check_cpln_links
+- script/precommit/check_trailing_newlines
+- script/precommit/get_changed_files
+- script/precommit/ruby_autofix
+- script/precommit/ruby_lint
 - script/rename_command
 - script/update_command_docs
 - templates/app.yml
@@ -224,14 +264,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.5.11
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: Control Plane Flow