@salesforce/afv-skills 1.58.0 → 1.60.0

package/skills/experience-ui-bundle-app-coordinate/scripts/check-dangling-refs.sh

@@ -1,42 +0,0 @@
-#!/usr/bin/env bash
-# Verify no surviving file still imports/references a file deleted during scaffold pruning
-# Usage: check-dangling-refs.sh <deleted-basename> [<deleted-basename> ...]
-#   <deleted-basename> is the file name without extension, e.g. "codegen" for codegen.yml,
-#   "graphqlClient" for src/api/graphqlClient.ts, "useAsyncData" for the deleted hook.
-# Exit 0 if no dangling references found, exit 1 with error message(s) if any are found.
-
-set -e
-
-if [ "$#" -eq 0 ]; then
-  echo "ERROR: check-dangling-refs.sh requires at least one deleted-file basename as an argument"
-  exit 1
-fi
-
-BUNDLE_DIR=$(find force-app/main/default/uiBundles -mindepth 1 -maxdepth 1 -type d 2>/dev/null | head -1)
-
-if [ -z "$BUNDLE_DIR" ]; then
-  echo "ERROR: No UI bundle directory found in force-app/main/default/uiBundles/"
-  exit 1
-fi
-
-FOUND_DANGLING=0
-
-for basename in "$@"; do
-  # Search all tracked source/config files (excluding node_modules, dist, build) for the
-  # basename — catches imports, requires, and config references (e.g. codegen.yml paths).
-  MATCHES=$(grep -rlF --exclude-dir=node_modules --exclude-dir=dist --exclude-dir=build \
-    --exclude-dir=.git -- "$basename" "$BUNDLE_DIR" 2>/dev/null || true)
-
-  if [ -n "$MATCHES" ]; then
-    echo "ERROR: Dangling reference to deleted file '$basename' found in:"
-    echo "$MATCHES" | sed 's/^/  - /'
-    FOUND_DANGLING=1
-  fi
-done
-
-if [ "$FOUND_DANGLING" -eq 1 ]; then
-  exit 1
-fi
-
-echo "SUCCESS: No dangling references found for: $*"
-exit 0

package/skills/experience-ui-bundle-app-coordinate/scripts/check-hosting-target.sh

@@ -1,26 +0,0 @@
-#!/usr/bin/env bash
-# Check which hosting target is configured in .uibundle-meta.xml files
-
-# Find all .uibundle-meta.xml files
-META_FILES=$(find . -name "*.uibundle-meta.xml" -type f 2>/dev/null)
-
-if [ -z "$META_FILES" ]; then
-  echo "ERROR: No .uibundle-meta.xml files found"
-  exit 1
-fi
-
-# Check for ExperienceSite target
-if echo "$META_FILES" | xargs grep -q '<target>ExperienceSite</target>' 2>/dev/null; then
-  echo "ExperienceSite"
-  exit 0
-fi
-
-# Check for CustomApplication target
-if echo "$META_FILES" | xargs grep -q '<target>CustomApplication</target>' 2>/dev/null; then
-  echo "CustomApplication"
-  exit 0
-fi
-
-# No valid target found
-echo "ERROR: No valid hosting target found in .uibundle-meta.xml"
-exit 1

package/skills/experience-ui-bundle-app-coordinate/scripts/check-phase-1-complete.sh

@@ -1,35 +0,0 @@
-#!/usr/bin/env bash
-# Verify Phase 1 (Scaffolding) completed successfully
-# Exit 0 if complete, exit 1 with error message if incomplete
-
-set -e
-
-BUNDLE_DIR=$(find force-app/main/default/uiBundles -mindepth 1 -maxdepth 1 -type d 2>/dev/null | head -1)
-
-if [ -z "$BUNDLE_DIR" ]; then
-  echo "ERROR: Phase 1 incomplete: No UI bundle directory found in force-app/main/default/uiBundles/"
-  exit 1
-fi
-
-if [ ! -d "$BUNDLE_DIR/src" ]; then
-  echo "ERROR: Phase 1 incomplete: No src/ directory found in $BUNDLE_DIR"
-  exit 1
-fi
-
-if ! ls "$BUNDLE_DIR"/*.uibundle-meta.xml >/dev/null 2>&1; then
-  echo "ERROR: Phase 1 incomplete: No .uibundle-meta.xml file found in $BUNDLE_DIR"
-  exit 1
-fi
-
-if ! grep -q '<target>' "$BUNDLE_DIR"/*.uibundle-meta.xml 2>/dev/null; then
-  echo "ERROR: Phase 1 incomplete: .uibundle-meta.xml missing <target> element"
-  exit 1
-fi
-
-if [ ! -f "$BUNDLE_DIR/package.json" ]; then
-  echo "ERROR: Phase 1 incomplete: No package.json found in $BUNDLE_DIR"
-  exit 1
-fi
-
-echo "SUCCESS: Phase 1 complete: Scaffold verified"
-exit 0

package/skills/experience-ui-bundle-app-coordinate/scripts/check-phase-4-complete.sh

@@ -1,47 +0,0 @@
-#!/usr/bin/env bash
-# Verify Phase 4 (UI) completed successfully
-# Exit 0 if complete, exit 1 with error message if incomplete
-
-set -e
-
-BUNDLE_DIR=$(find force-app/main/default/uiBundles -mindepth 1 -maxdepth 1 -type d 2>/dev/null | head -1)
-
-if [ -z "$BUNDLE_DIR" ]; then
-  echo "ERROR: Phase 4 cannot run: No UI bundle directory found (Phase 1 not complete)"
-  exit 1
-fi
-
-# Check Phase 1 scaffold prerequisites
-if [ ! -f "$BUNDLE_DIR/package.json" ]; then
-  echo "ERROR: Phase 4 cannot run: No package.json found (Phase 1 not complete)"
-  exit 1
-fi
-
-if ! grep -q '"react"' "$BUNDLE_DIR/package.json" 2>/dev/null; then
-  echo "ERROR: Phase 4 cannot run: React dependencies not installed in package.json"
-  exit 1
-fi
-
-# Check Phase 4 completion
-if [ ! -f "$BUNDLE_DIR/src/App.tsx" ]; then
-  echo "ERROR: Phase 4 incomplete: No App.tsx found in $BUNDLE_DIR/src/"
-  exit 1
-fi
-
-if [ ! -d "$BUNDLE_DIR/src/pages" ]; then
-  echo "ERROR: Phase 4 incomplete: No pages/ directory found in $BUNDLE_DIR/src/"
-  exit 1
-fi
-
-if [ -z "$(find "$BUNDLE_DIR/src/pages" -name '*.tsx' 2>/dev/null)" ]; then
-  echo "ERROR: Phase 4 incomplete: No .tsx files found in pages/ directory"
-  exit 1
-fi
-
-if [ ! -f "$BUNDLE_DIR/dist/index.html" ]; then
-  echo "ERROR: Phase 4 incomplete: No dist/index.html found (build not complete)"
-  exit 1
-fi
-
-echo "SUCCESS: Phase 4 complete: UI verified"
-exit 0

package/skills/experience-ui-bundle-app-coordinate/scripts/check-phase-6-ready.sh

@@ -1,33 +0,0 @@
-#!/usr/bin/env bash
-# Verify Phase 6 (Deployment) prerequisites are met
-# Exit 0 if ready, exit 1 with error message if not ready
-
-set -e
-
-BUNDLE_DIR=$(find force-app/main/default/uiBundles -mindepth 1 -maxdepth 1 -type d 2>/dev/null | head -1)
-
-if [ -z "$BUNDLE_DIR" ]; then
-  echo "ERROR: Phase 6 cannot run: No UI bundle directory found (Phase 1 not complete)"
-  exit 1
-fi
-
-# Check build artifact exists
-if [ ! -f "$BUNDLE_DIR/dist/index.html" ]; then
-  echo "ERROR: Phase 6 cannot run: No dist/index.html found (Phase 4 build not complete)"
-  exit 1
-fi
-
-# Check org authentication
-if ! sf org display --json >/dev/null 2>&1; then
-  echo "ERROR: Phase 6 cannot run: No authenticated org found (run: sf org login web)"
-  exit 1
-fi
-
-# Check hosting target is set
-if ! grep -q '<target>' "$BUNDLE_DIR"/*.uibundle-meta.xml 2>/dev/null; then
-  echo "ERROR: Phase 6 cannot run: .uibundle-meta.xml missing <target> element (Phase 1 not complete)"
-  exit 1
-fi
-
-echo "SUCCESS: Phase 6 ready: All deployment prerequisites met"
-exit 0

package/skills/experience-ui-bundle-app-coordinate/scripts/check-prerequisites.sh

@@ -1,20 +0,0 @@
-#!/usr/bin/env bash
-# Check prerequisites for UI Bundle app building
-# Exit 0 if all prerequisites met, exit 1 with error message if any missing
-
-set -e
-
-# Check Node.js version (requires >= 20.x)
-if ! command -v node >/dev/null 2>&1; then
-  echo "ERROR: Node.js not found. Install Node.js >= 20.x"
-  exit 1
-fi
-
-NODE_VERSION=$(node --version 2>/dev/null | sed 's/^v//' | cut -d. -f1)
-if [ "$NODE_VERSION" -lt 20 ]; then
-  echo "ERROR: Node.js version $NODE_VERSION detected. Requires >= 20.x"
-  exit 1
-fi
-
-echo "SUCCESS: Node.js v${NODE_VERSION} meets the >= 20.x requirement"
-exit 0

package/skills/experience-ui-bundle-app-coordinate/scripts/check-sfdx-project.sh

@@ -1,15 +0,0 @@
-#!/usr/bin/env bash
-# Check if sfdx-project.json exists and is valid JSON
-
-if [ ! -f sfdx-project.json ]; then
-  echo 'ERROR: sfdx-project.json not found'
-  exit 1
-fi
-
-# Validate JSON format using python (more portable than node)
-if ! python3 -c "import json; json.load(open('sfdx-project.json'))" 2>/dev/null; then
-  echo 'ERROR: sfdx-project.json is not valid JSON'
-  exit 1
-fi
-
-echo 'sfdx-project.json is valid'

package/skills/experience-ui-bundle-custom-app-generate/scripts/resolve-uibundle-path.sh

@@ -1,30 +0,0 @@
-#!/usr/bin/env bash
-# Resolve the existing path of a UIBundle's meta XML file.
-#
-# UIBundle metadata may live at either the nested bundle-style path
-# (uiBundles/{appName}/{appName}.uibundle-meta.xml) or, in older/hand-authored
-# projects, the flat path (uiBundles/{appName}.uibundle-meta.xml). This script
-# performs the deterministic file-existence check and prints whichever path
-# already exists, preferring the nested layout.
-#
-# Usage: scripts/resolve-uibundle-path.sh <appName>
-
-set -euo pipefail
-
-APP="${1:-}"
-if [ -z "$APP" ]; then
-  echo "ERROR: appName argument is required" >&2
-  exit 1
-fi
-
-NESTED="uiBundles/${APP}/${APP}.uibundle-meta.xml"
-FLAT="uiBundles/${APP}.uibundle-meta.xml"
-
-if [ -f "$NESTED" ]; then
-  echo "$NESTED"
-elif [ -f "$FLAT" ]; then
-  echo "$FLAT"
-else
-  echo "ERROR: no .uibundle-meta.xml found for $APP" >&2
-  exit 1
-fi

package/skills/experience-ui-bundle-frontend-generate/scripts/check-preconditions.sh

@@ -1,37 +0,0 @@
-#!/usr/bin/env bash
-# Verify a resolved UI bundle directory is actually scaffolded before any
-# rule in this skill applies.
-# Usage: check-preconditions.sh <bundle-dir>
-#   <bundle-dir> is the path printed by resolve-ui-bundle.sh.
-#
-# Exit 0 if the bundle is scaffolded (src/appLayout.tsx, src/routes.tsx, and
-# src/components/ui/ all present).
-# Exit 1 with the missing pieces listed if the bundle is a fresh SFDX
-# project, a non-UI-bundle React project, or only partially scaffolded —
-# the caller must stop and redirect the user to
-# experience-ui-bundle-app-coordinate (or experience-ui-bundle-metadata-generate)
-# instead of falling back to generic React knowledge.
-
-set -uo pipefail
-
-BUNDLE_DIR="${1:-}"
-
-if [ -z "$BUNDLE_DIR" ] || [ ! -d "$BUNDLE_DIR" ]; then
-  echo "ERROR: check-preconditions.sh requires a valid bundle directory argument" >&2
-  exit 1
-fi
-
-MISSING=()
-[ -f "$BUNDLE_DIR/src/appLayout.tsx" ] || MISSING+=("src/appLayout.tsx")
-[ -f "$BUNDLE_DIR/src/routes.tsx" ] || MISSING+=("src/routes.tsx")
-[ -d "$BUNDLE_DIR/src/components/ui" ] || MISSING+=("src/components/ui/")
-
-if [ "${#MISSING[@]}" -gt 0 ]; then
-  echo "ERROR: $BUNDLE_DIR is not a scaffolded UI bundle. Missing:" >&2
-  printf '  - %s\n' "${MISSING[@]}" >&2
-  echo "Stop here. Tell the user the bundle isn't scaffolded yet and direct them to experience-ui-bundle-app-coordinate (or experience-ui-bundle-metadata-generate) to scaffold it first." >&2
-  exit 1
-fi
-
-echo "SUCCESS: $BUNDLE_DIR is scaffolded (src/appLayout.tsx, src/routes.tsx, src/components/ui/ present)"
-exit 0

package/skills/experience-ui-bundle-frontend-generate/scripts/resolve-ui-bundle.sh

@@ -1,66 +0,0 @@
-#!/usr/bin/env bash
-# Resolve the single UI bundle directory for this project.
-# Usage: resolve-ui-bundle.sh [project-root]   (default: current directory)
-#
-# Reads sfdx-project.json's packageDirectories[0].path, looks under
-# <that-path>/main/default/uiBundles/, and prints the resolved bundle
-# directory to stdout on success.
-#
-# Exit 0: exactly one bundle directory found — printed to stdout.
-# Exit 1: sfdx-project.json missing/invalid, or no uiBundles/* subdirectory
-#         found at all (not a scaffolded SFDX project yet).
-# Exit 2: multiple uiBundles/* subdirectories found — caller MUST ask the
-#         user which one they mean rather than guessing; candidate names are
-#         printed to stderr.
-
-set -uo pipefail
-
-PROJECT_ROOT="${1:-.}"
-SFDX_PROJECT="$PROJECT_ROOT/sfdx-project.json"
-
-if [ ! -f "$SFDX_PROJECT" ]; then
-  echo "ERROR: sfdx-project.json not found at $SFDX_PROJECT" >&2
-  exit 1
-fi
-
-SOURCE_PATH=$(python3 -c "
-import json, sys
-try:
-    with open('$SFDX_PROJECT') as f:
-        data = json.load(f)
-    dirs = data.get('packageDirectories', [])
-    print(dirs[0].get('path', '') if dirs else '')
-except Exception:
-    print('')
-" 2>/dev/null)
-
-if [ -z "$SOURCE_PATH" ]; then
-  echo "ERROR: sfdx-project.json is invalid or has no packageDirectories[0].path" >&2
-  exit 1
-fi
-
-BUNDLES_DIR="$PROJECT_ROOT/$SOURCE_PATH/main/default/uiBundles"
-
-if [ ! -d "$BUNDLES_DIR" ]; then
-  echo "ERROR: No uiBundles/ directory found at $BUNDLES_DIR" >&2
-  exit 1
-fi
-
-BUNDLE_DIRS=()
-while IFS= read -r d; do
-  BUNDLE_DIRS+=("$d")
-done < <(find "$BUNDLES_DIR" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
-
-if [ "${#BUNDLE_DIRS[@]}" -eq 0 ]; then
-  echo "ERROR: $BUNDLES_DIR exists but contains no bundle subdirectories" >&2
-  exit 1
-fi
-
-if [ "${#BUNDLE_DIRS[@]}" -gt 1 ]; then
-  echo "AMBIGUOUS: Multiple UI bundle directories found — ask the user which one they mean before editing or running any command:" >&2
-  printf '  - %s\n' "${BUNDLE_DIRS[@]}" >&2
-  exit 2
-fi
-
-echo "${BUNDLE_DIRS[0]}"
-exit 0

package/skills/experience-ui-bundle-frontend-generate/scripts/verify-rules.sh

@@ -1,58 +0,0 @@
-#!/usr/bin/env bash
-# Grep-based verification of the hard, checkable rules in this skill that
-# `npm run lint` / `npm run build` do not catch on their own — a wrong
-# react-router-dom import, a hardcoded basename, an inline style prop, a
-# stray lightning/*-or-@wire import, or leftover template boilerplate can
-# all lint and build clean while breaking at runtime or shipping unfinished
-# branding.
-#
-# Usage: verify-rules.sh <file-or-dir> [<file-or-dir> ...]
-#   Pass the specific files you edited, or the bundle's src/ directory (and
-#   its index.html) to check everything.
-#
-# Exit 0 if no violations are found.
-# Exit 1 with every violation listed (rule + matching file paths) if any
-# are found — fix them before considering the task complete, even if lint
-# and build passed.
-
-set -uo pipefail
-
-if [ "$#" -eq 0 ]; then
-  echo "ERROR: verify-rules.sh requires at least one file or directory argument" >&2
-  exit 1
-fi
-
-for p in "$@"; do
-  if [ ! -e "$p" ]; then
-    echo "ERROR: path does not exist: $p" >&2
-    exit 1
-  fi
-done
-
-FOUND=0
-
-check() {
-  label="$1"
-  pattern="$2"
-  shift 2
-  hits=$(grep -rlE --include='*.ts' --include='*.tsx' --include='*.js' --include='*.jsx' --include='*.html' \
-    --exclude-dir=node_modules --exclude-dir=dist --exclude-dir=build -- "$pattern" "$@" 2>/dev/null || true)
-  if [ -n "$hits" ]; then
-    echo "ERROR: $label found in:" >&2
-    echo "$hits" | sed 's/^/  - /' >&2
-    FOUND=1
-  fi
-}
-
-check 'import from "react-router-dom" (must be "react-router")' 'from[[:space:]]+['"'"'"]react-router-dom['"'"'"]' "$@"
-check 'a hardcoded basename literal (must derive from <base href> at runtime)' 'basename:[[:space:]]*['"'"'"][/A-Za-z0-9_-]+['"'"'"]' "$@"
-check 'an inline style={{...}} prop (Tailwind utility classes only)' 'style=\{\{' "$@"
-check 'a forbidden lightning/* import or @wire usage (LWC-only)' 'from[[:space:]]+['"'"'"]lightning/|@wire' "$@"
-check 'leftover boilerplate branding (<title>React App</title> / Vite + React)' '<title>[^<]*React App[^<]*</title>|Vite[[:space:]]*\+[[:space:]]*React' "$@"
-
-if [ "$FOUND" -eq 1 ]; then
-  exit 1
-fi
-
-echo "SUCCESS: No hard-rule violations found in: $*"
-exit 0

package/skills/experience-ui-bundle-metadata-generate/scripts/check-api-version.sh

@@ -1,30 +0,0 @@
-#!/bin/bash
-# Checks that sourceApiVersion in sfdx-project.json is 67.0 or higher.
-# If lower, updates it to "67.0".
-
-set -e
-
-PROJECT_FILE="sfdx-project.json"
-
-if [[ ! -f "$PROJECT_FILE" ]]; then
-  echo "ERROR: $PROJECT_FILE not found in current directory"
-  exit 1
-fi
-
-# Extract sourceApiVersion and check if it's below 67.0
-version=$(jq -r '.sourceApiVersion // "0"' "$PROJECT_FILE")
-is_below=$(jq --arg v "$version" -n '($v | split(".") | .[0] | tonumber) < 67')
-
-if [[ "$is_below" == "true" ]]; then
-  echo "WARNING: sourceApiVersion is $version (< 67.0)"
-  echo "Updating $PROJECT_FILE to set sourceApiVersion to \"67.0\""
-
-  # Update the file
-  jq '.sourceApiVersion = "67.0"' "$PROJECT_FILE" > "$PROJECT_FILE.tmp"
-  mv "$PROJECT_FILE.tmp" "$PROJECT_FILE"
-
-  echo "OK: Updated sourceApiVersion to 67.0"
-  exit 0
-fi
-
-echo "OK: sourceApiVersion is $version (>= 67.0)"

package/skills/experience-ui-bundle-metadata-generate/scripts/detect-framework.sh

@@ -1,73 +0,0 @@
-#!/usr/bin/env bash
-#
-# detect-framework.sh — deterministic UI Bundle framework detector.
-#
-# Usage: bash detect-framework.sh [ROOT]
-#   ROOT  app or uiBundle root to inspect (default: current directory)
-#
-# Prints exactly one of the following tokens to stdout, nothing else, and sets
-# a matching exit code so callers can branch without parsing:
-#   react      (exit 0) — React signals only
-#   angular    (exit 0) — Angular signals only
-#   ambiguous  (exit 2) — both React and Angular signals present
-#   unknown    (exit 3) — neither framework detected
-#
-# Step 0 of the skill acts on the result: a single framework (exit 0) proceeds;
-# `ambiguous` asks the user to disambiguate; `unknown` TERMINATES the workflow
-# (no supported framework found — do not guess).
-
-set -u
-
-ROOT="${1:-.}"
-angular=0
-react=0
-
-# Resolve ROOT to an absolute path when possible (for the angular.json walk-up).
-abs_root="$(cd "$ROOT" 2>/dev/null && pwd || true)"
-
-# 1) angular.json at or above ROOT → Angular workspace.
-dir="$abs_root"
-while [ -n "$dir" ]; do
-  [ -f "$dir/angular.json" ] && angular=1
-  [ "$dir" = "/" ] && break
-  dir="$(dirname "$dir")"
-done
-
-# 2) package.json dependencies (excluding node_modules).
-while IFS= read -r pkg; do
-  [ -z "$pkg" ] && continue
-  grep -q '"@angular/core"' "$pkg" 2>/dev/null && angular=1
-  grep -Eq '"react"[[:space:]]*:' "$pkg" 2>/dev/null && react=1
-done <<EOF
-$(find "$ROOT" -type d -name node_modules -prune -o -type f -name package.json -print 2>/dev/null)
-EOF
-
-# 3) Source-file signatures (excluding node_modules).
-has_file() {
-  find "$ROOT" -type d -name node_modules -prune -o -type f -name "$1" -print 2>/dev/null | grep -q .
-}
-
-# Angular: component files, routing module, or @Component-decorated classes.
-has_file '*.component.ts' && angular=1
-has_file 'app.routes.ts' && angular=1
-if grep -rls --exclude-dir=node_modules --include='*.ts' '@Component' "$ROOT" 2>/dev/null | grep -q .; then
-  angular=1
-fi
-
-# React: JSX/TSX source files.
-has_file '*.tsx' && react=1
-has_file '*.jsx' && react=1
-
-if [ "$angular" -eq 1 ] && [ "$react" -eq 1 ]; then
-  echo ambiguous
-  exit 2
-elif [ "$angular" -eq 1 ]; then
-  echo angular
-  exit 0
-elif [ "$react" -eq 1 ]; then
-  echo react
-  exit 0
-else
-  echo unknown
-  exit 3
-fi

package/skills/experience-ui-bundle-metadata-generate/scripts/verify-bundle-location.sh

@@ -1,118 +0,0 @@
-#!/bin/bash
-# Verifies that a UI bundle was created under force-app/main/default/uiBundles/
-# (and not at the repo root, which would be non-deployable), AND that the
-# scaffold itself is complete (package.json, src/, entry index.html present) —
-# not just a hand-authored metadata-only directory.
-#
-# The entry index.html lives at the bundle root for React (reactbasic) and at
-# src/index.html for Angular (angularbasic), so both locations are accepted.
-#
-# If a custom output directory was used (--output-dir on the scaffold command),
-# pass it as the second argument. The script then verifies the bundle exists
-# there instead of assuming the default location. Pass the framework
-# (react|angular) as the third argument so the remediation hint uses the right
-# --template flag; pass "" for the second argument to supply only a framework.
-
-set -e
-
-if [[ $# -lt 1 || $# -gt 3 ]]; then
-  echo "ERROR: Bundle name required"
-  echo "Usage: bash verify-bundle-location.sh <BundleName> [<CustomOutputDir>] [<framework>]"
-  exit 1
-fi
-
-BUNDLE_NAME="$1"
-CUSTOM_OUTPUT_DIR="${2:-}"
-FRAMEWORK="${3:-}"
-
-# Pick the remediation template and the expected entry-HTML location from the
-# framework. When the framework is not supplied we stay lenient: default the
-# hint to reactbasic and accept the entry index.html at either location.
-case "$FRAMEWORK" in
-  angular) TEMPLATE="angularbasic"; ENTRY="src/index.html" ;;
-  react)   TEMPLATE="reactbasic";   ENTRY="index.html" ;;
-  *)       TEMPLATE="reactbasic";   ENTRY="" ;;
-esac
-
-# Checks that the scaffold actually produced a full project, not just
-# hand-written metadata files. Returns 1 (and prints guidance) if incomplete.
-# Pass a second argument with the --output-dir value when checking a bundle
-# in a custom location, so the remediation command matches where the bundle
-# actually needs to end up rather than always pointing at the default path.
-check_scaffold_complete() {
-  local bundle_path="$1"
-  local output_dir="${2:-}"
-  local missing=()
-  [[ -f "$bundle_path/package.json" ]] || missing+=("package.json")
-  [[ -d "$bundle_path/src" ]] || missing+=("src/")
-  # Entry HTML lives at the bundle root for React and at src/index.html for
-  # Angular. When the framework is known, require the correct location; when it
-  # is unknown, accept either.
-  if [[ -n "$ENTRY" ]]; then
-    [[ -f "$bundle_path/$ENTRY" ]] || missing+=("$ENTRY")
-  else
-    [[ -f "$bundle_path/index.html" || -f "$bundle_path/src/index.html" ]] || missing+=("index.html")
-  fi
-
-  if [[ ${#missing[@]} -gt 0 ]]; then
-    local scaffold_cmd="sf template generate ui-bundle -n $BUNDLE_NAME --template $TEMPLATE"
-    if [[ -n "$output_dir" ]]; then
-      scaffold_cmd="$scaffold_cmd --output-dir \"$output_dir\""
-    fi
-    echo "ERROR: Bundle found at $bundle_path, but the scaffold is incomplete. Missing:" >&2
-    printf '  - %s\n' "${missing[@]}" >&2
-    echo "" >&2
-    echo "This usually means 'sf template generate ui-bundle' was never run — metadata" >&2
-    echo "files alone were hand-authored instead. Run the scaffold command now:" >&2
-    echo "  $scaffold_cmd" >&2
-    echo "Metadata files are configuration ON TOP of the scaffold, not a substitute for it." >&2
-    return 1
-  fi
-  return 0
-}
-
-if [[ -n "$CUSTOM_OUTPUT_DIR" ]]; then
-  CUSTOM_PATH="$CUSTOM_OUTPUT_DIR/$BUNDLE_NAME"
-  if [[ -d "$CUSTOM_PATH" ]]; then
-    if check_scaffold_complete "$CUSTOM_PATH" "$CUSTOM_OUTPUT_DIR"; then
-      echo "OK: Bundle found at $CUSTOM_PATH (custom output-dir location, scaffold complete)"
-      exit 0
-    fi
-    exit 1
-  fi
-  echo "ERROR: Bundle not found at custom output-dir location: $CUSTOM_PATH"
-  echo "Check that --output-dir matched what was passed to the scaffold command."
-  exit 1
-fi
-
-EXPECTED_PATH="force-app/main/default/uiBundles/$BUNDLE_NAME"
-WRONG_PATH="uiBundles/$BUNDLE_NAME"
-
-if [[ -d "$EXPECTED_PATH" ]]; then
-  if check_scaffold_complete "$EXPECTED_PATH"; then
-    echo "OK: Bundle found at $EXPECTED_PATH (deployable location, scaffold complete)"
-    exit 0
-  fi
-  exit 1
-fi
-
-if [[ -d "$WRONG_PATH" ]]; then
-  echo "ERROR: Bundle found at repo root: $WRONG_PATH"
-  echo "This location is NOT deployable. The SFDX deploy command will not find it."
-  echo ""
-  echo "To fix: Move the bundle to force-app/main/default/uiBundles/"
-  echo "  mkdir -p force-app/main/default/uiBundles/ && mv $WRONG_PATH $EXPECTED_PATH"
-  echo ""
-  check_scaffold_complete "$WRONG_PATH" || true
-  exit 1
-fi
-
-echo "ERROR: Bundle not found at either location:"
-echo "  - Expected: $EXPECTED_PATH"
-echo "  - Also checked: $WRONG_PATH"
-echo ""
-echo "If a custom --output-dir was used, re-run this script with that directory"
-echo "as the second argument: bash verify-bundle-location.sh $BUNDLE_NAME <CustomOutputDir>"
-echo ""
-echo "Otherwise, the scaffold command may have failed. Check for errors above."
-exit 1