feat(deps): bump @backstage/* dependencies to be compatible with 1.52.0

[christoph-jerolimov]

Summary

• Bump all @backstage/* dependencies to Backstage release 1.52.0
• Add backstage:bump script to automate future upgrades with tilde pinning and deduplication
• Pin @backstage/cli* packages to exact versions (no tilde)
• Pin @backstage/config-loader via resolutions to avoid version conflicts
• Document the Backstage bump process in README.md

This is a fix for https://redhat.atlassian.net/browse/RHDHBUGS-3474, addressing the problem that the rhdh-cli 1.11.1 picked up transitive dependencies from new Backstage versions. In the case of this issue a newer config-loader failed now. The root case was a failure in the theme package and new additional added validation in the config-loader.

This PR changes the dependencies of rhdh-cli from ^ to ~ so that the cli doesn't pick up newer versions of Backstage dependencies. I've reproduced the problem with the intelligent-assistant plugin:

• Repo: rhdh-plugins
• Plugin: workspaces/intelligent-assistant/plugins/intelligent-assistant
• Commit: c1e6d0fd17 (before the theme was updated to incl. a related fix)

reproduce.sh

#!/usr/bin/env bash
set -euo pipefail

CLI_DIR="$(cd "$(dirname "$0")" && pwd)"
PLUGIN_DIR=~/git/rhd/rhdh-plugins/workspaces/intelligent-assistant/plugins/intelligent-assistant

echo "=== Building rhdh-cli ==="
cd "$CLI_DIR"
yarn build
yarn pack --filename rhdh-cli.tgz
npm install -g "$CLI_DIR/rhdh-cli.tgz"

test1=0
test2=0

echo ""
echo "=== Test 1: plugin export via local bin/rhdh-cli ==="
cd "$PLUGIN_DIR"
rm -rf dist dist-dynamic
if "$CLI_DIR/bin/rhdh-cli" plugin export; then
  test1=0
else
  test1=1
fi

echo ""
echo "=== Test 2: plugin export via globally installed rhdh-cli ==="
cd "$PLUGIN_DIR"
rm -rf dist dist-dynamic
if rhdh-cli plugin export; then
  test2=0
else
  test2=1
fi

echo ""
echo "=== Results ==="
[ "$test1" -eq 0 ] && echo "Test 1 (local bin/rhdh-cli):     PASS" || echo "Test 1 (local bin/rhdh-cli):     FAIL"
[ "$test2" -eq 0 ] && echo "Test 2 (npm installed rhdh-cli): PASS" || echo "Test 2 (npm installed rhdh-cli): FAIL"

exit $((test1 + test2))

main (rhdh-cli 1.11.1) (b56f504)

Test 1 (local bin/rhdh-cli):     PASS
Test 2 (npm installed rhdh-cli): FAIL

main branch with update dependencies and pinned versions for cli-defaults, cli-module-build and cli-module-config

Test 1 (local bin/rhdh-cli):     PASS
Test 2 (npm installed rhdh-cli): PASS

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud