feat: add automated konsolerc geometry sanitization and git backup integration

- Implement [MainWindow] section stripping in backup and restore scripts
  to prevent screen geometry/monitor layout noise across devices
- Add robust hostname detection and customizable archive naming in backup.sh
- Add optional interactive git commit and push prompt upon successful backup
- Update restore.sh diff preview and extraction to respect sanitized konsolerc
- Add AGENTS.md documentation detailing script architecture and conventions

backup.sh

@@ -6,10 +6,33 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 BACKUP_DIR="${SCRIPT_DIR}/backups"
 mkdir -p "${BACKUP_DIR}"
 
-# Timestamp for archive name
+# Pre-flight requirements check for core tools
+for cmd in zip awk find mktemp; do
+    if ! command -v "${cmd}" >/dev/null 2>&1; then
+        echo "Error: Required tool '${cmd}' is not installed or not in PATH." >&2
+        exit 1
+    fi
+done
+
+# Determine device hostname using robust fallbacks (no inetutils required)
+HOSTNAME_STR=""
+if command -v hostname >/dev/null 2>&1; then
+    HOSTNAME_STR="$(hostname -s 2>/dev/null || hostname 2>/dev/null || true)"
+fi
+if [ -z "${HOSTNAME_STR}" ]; then
+    HOSTNAME_STR="${HOST:-${HOSTNAME:-}}"
+fi
+if [ -z "${HOSTNAME_STR}" ] && [ -r /proc/sys/kernel/hostname ]; then
+    HOSTNAME_STR="$(cat /proc/sys/kernel/hostname 2>/dev/null || true)"
+fi
+if [ -z "${HOSTNAME_STR}" ] && [ -r /etc/hostname ]; then
+    HOSTNAME_STR="$(cat /etc/hostname 2>/dev/null || true)"
+fi
+HOSTNAME_STR="$(echo "${HOSTNAME_STR:-}" | xargs)"
+[ -z "${HOSTNAME_STR}" ] && HOSTNAME_STR="host"
+
 TIMESTAMP="$(date +"%Y%m%d_%H%M%S")"
-ZIP_FILENAME="konsole_backup_${TIMESTAMP}.zip"
-ZIP_FILEPATH="${BACKUP_DIR}/${ZIP_FILENAME}"
+DEFAULT_FILENAME="konsole_backup_${HOSTNAME_STR}_${TIMESTAMP}.zip"
 
 # Temporary staging directory
 TEMP_DIR="$(mktemp -d)"
@@ -34,8 +57,18 @@ for rel_path in "${CONFIG_PATHS[@]}"; do
 
     if [ -e "${src_path}" ]; then
         mkdir -p "$(dirname "${dest_path}")"
-        cp -a "${src_path}" "${dest_path}"
-        echo " [+] Staged: ~/${rel_path}"
+        if [ "${rel_path}" = ".config/konsolerc" ]; then
+            # Filter out [MainWindow] section to avoid machine-specific geometry/monitor noise
+            awk '
+                /^\[MainWindow\]/ { skip=1; next }
+                /^\[.*\]/ { skip=0 }
+                !skip { print }
+            ' "${src_path}" > "${dest_path}"
+            echo " [+] Staged & Sanitized: ~/${rel_path}"
+        else
+            cp -a "${src_path}" "${dest_path}"
+            echo " [+] Staged: ~/${rel_path}"
+        fi
         COPIED_COUNT=$((COPIED_COUNT + 1))
     else
         echo " [-] Skipped (not found): ~/${rel_path}"
@@ -47,6 +80,43 @@ if [ "${COPIED_COUNT}" -eq 0 ]; then
     exit 1
 fi
 
+# Determine appropriate interactive input source
+get_input() {
+    local prompt_msg="$1"
+    local var_name="$2"
+    local default_val="${3:-}"
+
+    if [ -t 0 ]; then
+        read -r -p "${prompt_msg}" "$var_name" || true
+    elif [ -c /dev/tty ] && [ -r /dev/tty ] && { : < /dev/tty; } 2>/dev/null; then
+        read -r -p "${prompt_msg}" "$var_name" < /dev/tty || true
+    else
+        read -r -p "${prompt_msg}" "$var_name" || true
+    fi
+
+    if [ -z "${!var_name:-}" ] && [ -n "${default_val}" ]; then
+        eval "${var_name}=\"${default_val}\""
+    fi
+}
+
+echo ""
+# Prompt user for backup filename (like ssh-keygen)
+CHOSEN_NAME=""
+get_input "Enter backup filename [default: ${DEFAULT_FILENAME}]: " CHOSEN_NAME "${DEFAULT_FILENAME}"
+CHOSEN_NAME="$(echo "${CHOSEN_NAME:-}" | xargs)"
+
+if [ -z "${CHOSEN_NAME}" ]; then
+    ZIP_FILENAME="${DEFAULT_FILENAME}"
+else
+    if [[ "${CHOSEN_NAME}" != *.zip ]]; then
+        ZIP_FILENAME="${CHOSEN_NAME}.zip"
+    else
+        ZIP_FILENAME="${CHOSEN_NAME}"
+    fi
+fi
+
+ZIP_FILEPATH="${BACKUP_DIR}/${ZIP_FILENAME}"
+
 # Create zip file from staging area
 echo "Creating backup archive: ${ZIP_FILENAME}..."
 (
@@ -67,8 +137,33 @@ if [ "${TOTAL_BACKUPS}" -gt "${MAX_BACKUPS}" ]; then
     for (( i=MAX_BACKUPS; i<TOTAL_BACKUPS; i++ )); do
         file_to_remove="${BACKUP_FILES[$i]}"
         echo " Deleting old backup: $(basename "${file_to_remove}")"
-        rm -f "${file_to_remove}"
+        if git rev-parse --is-inside-work-tree &>/dev/null; then
+            git rm -f "${file_to_remove}" 2>/dev/null || rm -f "${file_to_remove}"
+        else
+            rm -f "${file_to_remove}"
+        fi
     done
 fi
 
 echo "=== Backup Complete (${TOTAL_BACKUPS} backup(s) currently stored) ==="
+echo ""
+
+# Optional Git Commit & Push
+if git rev-parse --is-inside-work-tree &>/dev/null; then
+    git_choice=""
+    get_input "Do you want to commit and push this backup to git? [y/N]: " git_choice "n"
+    case "${git_choice,,}" in
+        y|yes)
+            echo "Staging backup file in git..."
+            git add "${ZIP_FILEPATH}"
+            COMMIT_MSG="chore(konsole): backup config from ${HOSTNAME_STR} at ${TIMESTAMP}"
+            echo "Committing: \"${COMMIT_MSG}\"..."
+            git commit -m "${COMMIT_MSG}" || true
+            echo "Pushing to remote repository..."
+            git push || echo "Warning: git push failed. Please check your git remote configuration."
+            ;;
+        *)
+            echo "Skipping git push."
+            ;;
+    esac
+fi