[b/r] Add live progress reporting for OADP restore waits

Replace until/retries polling with a shell loop that writes progress
directly to /dev/tty for live visibility during Ansible execution.
Shows phase and items restored count.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: stuggi

docs/dev/backup-restore/restore/wait-for-restore.yaml

@@ -11,15 +11,30 @@
 #   restore_timeout: Timeout in seconds (default: 900)
 #   strict_restore: Fail on PartiallyFailed (default: true)
 
-- name: "{{ step_name }}: Poll restore phase"
+- name: "{{ step_name }}: Wait for restore with progress"
   ansible.builtin.shell: |
-    oc get restore {{ restore_name }} -n {{ oadp_namespace | default('openshift-adp') }} \
-      -o jsonpath='{.status.phase}' 2>/dev/null || echo "NotFound"
+    RESTORE_NAME="{{ restore_name }}"
+    NS="{{ oadp_namespace | default('openshift-adp') }}"
+    TIMEOUT={{ restore_timeout | default(900) }}
+    ELAPSED=0
+    while [ $ELAPSED -lt $TIMEOUT ]; do
+      read -r PHASE ITEMS_DONE ITEMS_TOTAL <<< $(oc get restore ${RESTORE_NAME} -n ${NS} \
+        -o jsonpath='{.status.phase} {.status.progress.itemsRestored} {.status.progress.totalItems}' 2>/dev/null)
+      PHASE=${PHASE:-Pending}
+      PROGRESS="Phase: ${PHASE} | Items: ${ITEMS_DONE:-0}/${ITEMS_TOTAL:-?}"
+      echo "  $(date +%H:%M:%S) ${PROGRESS}" > /dev/tty
+      case "${PHASE}" in
+        Completed|PartiallyFailed|Failed|FailedValidation)
+          echo "${PHASE}"
+          exit 0 ;;
+      esac
+      sleep 10
+      ELAPSED=$((ELAPSED + 10))
+    done
+    echo "Timeout waiting for restore ${RESTORE_NAME} after $((TIMEOUT/60))m" >&2
+    exit 1
   register: restore_phase
   changed_when: false
-  until: restore_phase.stdout in ["Completed", "PartiallyFailed", "Failed", "FailedValidation"]
-  retries: "{{ ((restore_timeout | default(900)) | int / 10) | int }}"
-  delay: 10
 
 - name: "{{ step_name }}: Get restore details on non-Completed phase"
   ansible.builtin.shell: |