@deeeed/metamask-harness 0.17.3 → 0.17.5

package/adapters/mobile/cleanup.sh

@@ -1,36 +1,196 @@
 #!/usr/bin/env bash
-# Remove checkout-local Mobile harness metadata without touching product source.
+# cleanup.sh — remove the mobile harness overlay from a checkout
+#
+# Purpose:
+#   Restores backed-up product files (full installs), removes exactly the
+#   .git/info/exclude entries the install recorded, then deletes the harness
+#   dir and backup store. Metadata-only installs remove metadata alone.
+#
+# Inputs (flags / env):
+#   --target <metamask-mobile> (default $PWD)
+#   --allow-managed-changes   skip the managed-hash refusal
+#   env RECIPE_HARNESS_ROOT
+#
+# Outputs:
+#   Removes <harness>/ and backup dir; restores managed product paths.
+#   Exit 0 — cleaned; 1 — no backup state / changed managed paths refusal /
+#   missing backup; 2 — bad args.
+#
+# Never touches: product files other than the recorded managed paths;
+# .git/info/exclude lines it did not record; product-local cache dirs.
 set -euo pipefail
 
 TARGET="$PWD"
+ALLOW_MANAGED_CHANGES=false
 while [ "$#" -gt 0 ]; do
   case "$1" in
-    --target) [ "$#" -ge 2 ] || { echo "Missing value for --target" >&2; exit 2; }; TARGET="$2"; shift 2 ;;
-    -h|--help) echo "Usage: cleanup.sh [--target <metamask-mobile>]"; exit 0 ;;
+    --target) TARGET="$2"; shift 2 ;;
+    --allow-managed-changes) ALLOW_MANAGED_CHANGES=true; shift ;;
+    -h|--help) echo "Usage: cleanup.sh [--target <metamask-mobile>] [--allow-managed-changes]"; exit 0 ;;
     *) echo "Unknown arg: $1" >&2; exit 2 ;;
   esac
 done
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-. "$SCRIPT_DIR/../shared/harness-path.sh"
-TARGET="$(cd "$TARGET" && pwd -P)"
+TARGET="$(cd "$TARGET" && pwd)"
+# shellcheck disable=SC1091
+. "$SCRIPT_DIR/../shared/hash-helpers.sh"
+# shellcheck disable=SC1091
+for _hp in "$SCRIPT_DIR/../shared/harness-path.sh"; do
+  [ -f "$_hp" ] && { . "$_hp"; break; }
+done
+unset _hp
+if ! command -v harness_root >/dev/null 2>&1; then
+  echo "mm-harness: shared lib adapters/shared/harness-path.sh not found; reinstall the runner." >&2
+  exit 1
+fi
 HARNESS_DIR="$(harness_dir "$TARGET" mobile)"
 
+# A console-forwarder left running would keep polling for this checkout's Metro
+# after cleanup orphans it; stop any forwarder scoped to this checkout first.
 pkill -f "console-forwarder.cjs --port .* --out $TARGET/" 2>/dev/null || true
+if GIT_BACKUP_PATH="$(git -C "$TARGET" rev-parse --git-path recipe-harness/mobile/backup 2>/dev/null)"; then
+  case "$GIT_BACKUP_PATH" in
+    /*) BACKUP_DIR="$GIT_BACKUP_PATH" ;;
+    *) BACKUP_DIR="$TARGET/$GIT_BACKUP_PATH" ;;
+  esac
+else
+  BACKUP_DIR="$HARNESS_DIR/backup-store"
+fi
+if [ ! -f "$BACKUP_DIR/state.env" ] && [ -f "$HARNESS_DIR/backup/state.env" ]; then
+  BACKUP_DIR="$HARNESS_DIR/backup"
+fi
+STATE_FILE="$BACKUP_DIR/state.env"
+
+remove_recorded_git_exclude_entries() {
+  local tracking_file="$1"
+  [ -s "$tracking_file" ] || return 0
+  local git_dir exclude_file tmp_file
+  if ! git_dir="$(git -C "$TARGET" rev-parse --git-dir 2>/dev/null)"; then
+    return 0
+  fi
+  case "$git_dir" in
+    /*) ;;
+    *) git_dir="$TARGET/$git_dir" ;;
+  esac
+  exclude_file="$git_dir/info/exclude"
+  [ -f "$exclude_file" ] || return 0
+  # Remove only the lines THIS install recorded, one occurrence per distinct
+  # ledger entry (the appended copy is the last match), so a pre-existing
+  # duplicate copy or a stale/duplicate ledger entry never drops a line we did
+  # not add this run.
+  tmp_file="$(mktemp)"
+  awk '
+    NR==FNR { if (length($0)) want[$0]=1; next }
+    { lines[++n]=$0; if ($0 in want) last[$0]=n }
+    END { for (k in last) drop[last[k]]=1; for (i=1;i<=n;i++) if (!(i in drop)) print lines[i] }
+  ' "$tracking_file" "$exclude_file" > "$tmp_file"
+  mv "$tmp_file" "$exclude_file"
+}
+
+if [ -f "$HARNESS_DIR/manifest.json" ] && node -e '
+    const fs = require("fs");
+    const manifest = JSON.parse(fs.readFileSync(process.argv[1], "utf8"));
+    process.exit(manifest.installMode === "product-owned" ? 0 : 1);
+  ' "$HARNESS_DIR/manifest.json" 2>/dev/null; then
+  remove_recorded_git_exclude_entries "$HARNESS_DIR/added-git-exclude"
+  rm -rf "$HARNESS_DIR"
+  echo "Cleaned mobile recipe harness metadata from $TARGET (product-owned in-app bridge files left untouched)"
+  exit 0
+fi
+
+if [ ! -f "$STATE_FILE" ]; then
+  if [ -f "$HARNESS_DIR/manifest.json" ] && node -e '
+    const fs = require("fs");
+    const manifest = JSON.parse(fs.readFileSync(process.argv[1], "utf8"));
+    process.exit(manifest.installMode === "product-owned" ? 0 : 1);
+  ' "$HARNESS_DIR/manifest.json" 2>/dev/null; then
+    remove_recorded_git_exclude_entries "$HARNESS_DIR/added-git-exclude"
+    rm -rf "$HARNESS_DIR"
+    echo "Cleaned mobile recipe harness metadata from $TARGET (product-owned in-app bridge files left untouched)"
+    exit 0
+  fi
+  echo "No mobile harness backup found at $STATE_FILE" >&2
+  exit 1
+fi
+
+while IFS= read -r _line || [ -n "$_line" ]; do
+  [[ "$_line" =~ ^[[:space:]]*(#|$) ]] && continue
+  _key="${_line%%=*}"
+  _val="${_line#*=}"
+  case "$_key" in
+    AGENTIC_SERVICE_EXISTED|PACKAGE_JSON_EXISTED|NAVIGATION_SERVICE_EXISTED|APP_TSX_EXISTED) ;;
+    *) continue ;;
+  esac
+  export "$_key=$_val"
+done < "$STATE_FILE"
+unset _line _key _val
+
+HASH_FILE="$BACKUP_DIR/managed-hashes.tsv"
+
+verify_managed_paths_unchanged() {
+  if [ ! -f "$HASH_FILE" ]; then
+    cat >&2 <<EOF
+Refusing cleanup: no managed hash file found at $HASH_FILE.
+Re-run mobile harness install from the current runner to refresh safety metadata, or restore manually.
+EOF
+    exit 1
+  fi
+  local rel expected actual conflicts=0
+  while IFS=$'\t' read -r rel expected; do
+    [ -n "$rel" ] || continue
+    actual="$(hash_path "$rel")"
+    if [ "$actual" != "$expected" ]; then
+      echo "Refusing cleanup: managed harness path changed after install: $rel" >&2
+      echo "  expected: $expected" >&2
+      echo "  actual:   $actual" >&2
+      conflicts=1
+    fi
+  done < "$HASH_FILE"
+  if [ "$conflicts" != "0" ]; then
+    cat >&2 <<EOF
+Cleanup would restore backups over files that changed after harness install.
+Save/stash those changes, rerun harness install to refresh managed hashes, or restore manually.
+EOF
+    exit 1
+  fi
+}
+
+if [ "$ALLOW_MANAGED_CHANGES" != "true" ]; then
+  verify_managed_paths_unchanged
+else
+  echo "Allowing cleanup over changed managed harness paths."
+fi
 
-tracking_file="$HARNESS_DIR/added-git-exclude"
-if [ -s "$tracking_file" ]; then
-  git_dir="$(git -C "$TARGET" rev-parse --git-dir 2>/dev/null || true)"
-  if [ -n "$git_dir" ]; then
-    case "$git_dir" in /*) ;; *) git_dir="$TARGET/$git_dir" ;; esac
-    exclude_file="$git_dir/info/exclude"
-    if [ -f "$exclude_file" ]; then
-      tmp_file="$(mktemp)"
-      awk 'NR==FNR { if (length($0)) drop[$0]=1; next } !($0 in drop)' "$tracking_file" "$exclude_file" > "$tmp_file"
-      mv "$tmp_file" "$exclude_file"
+restore_path() {
+  local rel="$1"
+  local existed="$2"
+  local target_path="$TARGET/$rel"
+  local backup_path="$BACKUP_DIR/$rel"
+  if [ "$existed" = "1" ]; then
+    if [ ! -e "$backup_path" ]; then
+      echo "Missing backup for $rel at $backup_path" >&2
+      exit 1
     fi
+    rm -rf "$target_path"
+    mkdir -p "$(dirname "$target_path")"
+    cp -a "$backup_path" "$target_path"
+  else
+    rm -rf "$target_path"
   fi
+}
+
+restore_path "app/dev-tools/AgenticService" "${AGENTIC_SERVICE_EXISTED:-0}"
+if [ "${PACKAGE_JSON_EXISTED+x}" = "x" ]; then
+  restore_path "package.json" "$PACKAGE_JSON_EXISTED"
 fi
+restore_path "app/core/NavigationService/NavigationService.ts" "${NAVIGATION_SERVICE_EXISTED:-0}"
+restore_path "app/components/Nav/App/App.tsx" "${APP_TSX_EXISTED:-0}"
+
+remove_recorded_git_exclude_entries "$BACKUP_DIR/added-git-exclude"
 
+# Leave any product-local cache dirs alone: they are owned by the product
+# checkout, not the harness.
 rm -rf "$HARNESS_DIR"
-echo "Cleaned mobile harness metadata from $TARGET; product files were not touched"
+rm -rf "$BACKUP_DIR"
+echo "Cleaned mobile recipe harness from $TARGET"